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Notices 



References in this publication to products, programs, or services do 
not imply that the manufacturer intends to make these available in all 
countries in which the manufacturer operates. Any reference to a 
product, program, or service is not intended to state or imply that 
only the manufacturer's product, program, or service may be used. 
Any functionally equivalent product, program, or service that does not 
infringe upon any of the manufacturer's intellectual property rights or 
other legally protectable rights may be used instead of the product, 
program, or service. Evaluation and verification of operation in 
conjunction with other products, programs, or services, except those 
expressly designated by the manufacturer, are the user's 
responsibility. 

The publication of the information contained herein is not 
intended to and does not convey any rights or licenses, express 
or implied, under any patents, copyrights, trademarks, mask 
works or any other intellectual property rights. 

The manufacturer may have patents or pending patent applications 
covering subject matter in this document. The furnishing of this 
document does not give you any license to these patents. You can 
send license inquiries, in writing, to the IBM Director of Commercial 
Relations, IBM Corporation, 208 Harbor Drive, Stamford, 
Connecticut, USA 06904. 
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Data Security 

Warning: There is a potential data security risk if you assign 
identical addresses to multiple devices in the address search list. 
When using the address search list, the workstation addresses can 
be automatically assigned to sessions on the personal computer. If 
the personal computer or the host system has a failure, you might 
have a different workstation address assigned during recovery than 
was assigned before the failure. As a result, the user may be 
allowed access to another user's application after recovery. 

To minimize the potential data security risk, you should do the 
following: 

• If you write your own application program, it should be written to 
require each user to sign on with a security password before the 
host system will re-establish a session. 

• If you use an application program that does not require a 
security password before re-establishing a session, you should 
always have the system operator do the following: 

- Cancel the job if either the personal computer or host system 
failure occurs during the session and the session is lost. 

- Cancel any spool writer job for a printer session, when 
applicable. 

The Emulation Program and adapter, with the personal computer, 
make a powerful and useful tool to help you with your personal and 
business information processing needs. As with any information 
system, inadvertent errors may occur and information may be 
misused. We suggest that when processing sensitive or highly 
valuable information, you take steps to ensure that your data and 
programs are protected from accidental or unauthorized disclosure, 
modification, destruction, or misuse. Simple measures, such as 
removing diskettes when not in use, keeping backup copies of 
valuable information, or installing the equipment in a secure facility, 
can go a long way to maintain the integrity and privacy of your 
information. 
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Trademarks 



The following terms, denoted by an asterisk (*) in this publication, are 
trademarks of the IBM Corporation in the United States or other 
countries or both: 



AS/400 

ExecJet 

Micro Channel 

Operating System/400 

PC/XT 

Personal Computer XT 
Personal System/2 
PS/1 

PS/ValuePoint 
Quietwriter 



AT 
IBM 

OfficeVision 
OS/2 

Personal Computer AT 
Personal System/1 
Proprinter 
PS/2 

Quickwriter 
ThinkPad 



The following terms, denoted by a double asterisk (**) in this 
publication, are trademarks of other companies: 

Intel Intel Corporation 

Microsoft Microsoft Corporation 

PC Direct Ziff Communications Company 1 



1 PC Direct is used by IBM under license. 
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Technical Assistance 



IBM provides program service to customers through a Registered 
Technical Coordinator, who acts as an interface between the 
customer and the IBM* Support Center. The Technical Coordinator 
is designated when the program license is acquired. Depending on 
the type of contract and where the program license is acquired, the 
Technical Coordinator can be an IBM Authorized dealer, distributor, 
or remarketer; an IBM representative; or a designated representative 
of the customer. 

Direct any questions regarding Technical Coordinators to the supplier 
of the program. 

The IBM Support Center provides registered Technical Coordinators 
with telephone assistance in problem diagnosis and resolution. The 
registered Technical Coordinator can call the IBM Support Center at 
1 -800-237-551 1 any time and receive a return call within eight 
business hours (Monday-Friday, 8 a.m.-5 p.m., local customer time). 

Outside the United States or Puerto Rico, contact your local IBM 
representative or your Authorized IBM Supplier for information 

on program services. 
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Preface 



This manual explains how to use a personal computer 2 with the 
Enhanced 5250 Emulation Program (Emulation Program) when 
attached to a host 3 that supports the 5250 Information Display 
System. 

Note: For information on 5250 Emulation compatibility with 
non referenced personal computer systems, contact your IBM 
Marketing Representative or your IBM Authorized Dealer, 
Remarketer, or Distributor or call 1-800-955-5250. 

Before using the Emulation Program, you should have some 
knowledge of your personal computer, the IBM Disk Operating 
System (DOS), the IBM 5250 Information Display System, and your 
host system. This manual does not teach you how to use the host 
functions. 

DOS Version 5.0 or later is required for all systems. 

The Emulation Program lets you emulate (imitate the functions of) a 
subset of the IBM 5250 display stations and printers and use the 
functions of your host. The program supports IBM 3196 
monochrome display emulation or IBM 3197 color display emulation 
and the IBM 5219, 5224, 5225, and 5256 Printer functions. A 
compatible 5250 emulation adapter and this program enable a 
personal computer to perform the function of two host displays or 
one display and one printer at the same time on one host line 
connection. Access to the personal computer DOS session is also 
provided via a user-defined hot key. 



2 In this manual, personal computer refers to ISA (PC AT,* ISA, or EISA) and 
Micro Channel* bus personal computers and to personal computers equipped with 
PCMCIA Type II or Type III slots, including: PS/1,* PSA/P, PS/2,* and personal 
computers (as defined in "Terminology" on page xxiii). 

3 Host refers to the IBM AS/400,* the IBM System/36, or the IBM System/38. 
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For information about changes and additions to the program that 
were made after this book was published, see the README.DOC file 
on the program diskette. 

To display this file: 

1. Insert the program diskette into the A: drive. 

2. Change to the A: drive. 

3. Enter the following command: 
TYPE README.DOC | MORE 

4. To see the next screen of information, press Enter. 

Organization of This Manual 

The manual is primarily for the person who will be using the personal 
computer to emulate display stations and printers after the personal 
computer is connected to a host. 

Below is a summary of each chapter and appendix: 

• Chapter 1, Quick Start Instructions for the Emulation Program, 
provides an overview of how to install, configure, and use the 
Emulation Program. This chapter is for people who are using the 
basic functions that the Emulation Program provides for 
communicating with the host. 

• Chapter 2, Getting Ready for 5250 Emulation, gives information 
needed for planning the attachment of the personal computer to 
a host. This chapter is for the person responsible for planning 
and installing your personal computer. 

• Chapter 3, Detailed Installation and Configuration, gives detailed 
instructions for installing and configuring the Emulation Program. 
This chapter also provides information about configuring your 
adapter, resolving adapter conflicts, using the Emulation Program 
under OS/2,* and updating session profiles to Version 2.4 of the 
Emulation Program. 

• Chapter 4, Operating the Emulation Program, describes how to 
load the Emulation Program onto your personal computer and 
how to use the functions of the program. 
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Chapter 5, Using the Display Screens, describes the emulation 
display. 

Chapter 6, Using the Keyboard, describes how the personal 
computer keyboards emulate the IBM 5250 keyboards. 

Chapter 7, Emulating an IBM 5219 Printer, describes the 
emulated control panel for the IBM 5219 and shows how the IBM 
5219 Printer is emulated on the personal computer attached 
printers. 

Chapter 8, Emulating an IBM 5224 Printer, describes the 
emulated control panels for the IBM 5224 and shows how the 
IBM 5224 Printer is emulated on the personal computer attached 
printers. 

Chapter 9, Emulating an IBM 5256 Printer, describes the 
emulated control panels for the IBM 5256 and shows how the 
IBM 5256 Printer is emulated on the personal computer printers. 

Chapter 10, Using the Printer Function Table Setup Program, 
provides information about using the Printer Function Tables and 
user-defined printers. 

Chapter 11, Advanced Configuration, explains the advanced 
configuration options. 

Appendix A, Error Codes and Messages, lists error codes and 
messages with their causes and recovery procedures. 

Appendix B, Problem Determination, describes how to diagnose 
and correct problems that might occur during installation and 
operation. 

Appendix C, PCMCIA Setup Considerations, gives detailed 
information about configuring the 5250 Emulation PCMCIA 
Adapter. 

Appendix D, Files on the Program Diskette, describes the files 
on the program diskette. 

Appendix E, Keyboards, contains keyboard reference 
information, including how major 5250 functions are mapped to 
personal computer keyboards, which keyboard customization 
files are provided with the Emulation Program, and how the 
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enhanced style keyboard is layed out for each of the supported 
languages. 

This manual also contains a glossary and an index. 

You should have some knowledge of how to use your personal 
computer, including its operating system. Therefore, it is important 
that you read and understand the Getting Started and Guide to 
Operations manuals for your personal computer. You might also 
want to refer to the manual that was provided with your operating 
system. 

The person responsible for running the more technical portion of the 
configuration program or for modifying the host or local programs 
should become familiar with the Enhanced 5250 Emulation Program 
Version 2.3 Technical Reference (G570-2222). 

Note: Unless specified otherwise, all references to the Technical 
Reference manual that are made in this book refer to the Enhanced 
5250 Emulation Program Version 2.3 Technical Reference. 

The person responsible for installing and configuring the IBM 5250 
Emulation Family adapter should read and understand the Guide to 
Operations or Insiaiiaiion and Test instructions manual that was 
provided with the adapter. Technical Reference manuals are 
available for each of the IBM 5250 Emulation Family adapters: 

For ISA (Industry Standard Architecture) bus personal 

computers: IBM Enhanced 5250 Display Station Emulation 
Adapter Technical Reference (G570-2225) 

For Micro Channel bus personal computers: IBM 5250 

Emulation Adapter/A Technical Reference (G57 1-0261) 

For PCMCIA bus personal computers: IBM 5250 Emulation 
PCMCIA Adapter Technical Reference (G571-0265) 



xxii 



Enhanced 5250 User's Guide 



Related Books 

You might find the following related books helpful. 

• IBM 5250 Information Display System Planning and Site 
Preparation Guide, GA2 1-9337 

• IBM 5250 Information Display System Functions Reference 
Manual, SA21-9247 

• IBM 3196 Display Station User's Guide, GA1 8-2482 

• IBM 3197 Model C Color Display Station User's Guide, 
GA1 8-2559 

• IBM 5219 Printer Model D01/D02 Setup Procedures/Operator's 
Guide, GA23-1019 

• IBM 5224 Printer Operator's Guide, GA34-0095 

• IBM 5225 Printer Operator's Guide, GA34-0054 

• IBM 5256 Printer Operator's Guide, GA21 -9260 

• IBM 5294 Control Unit Operator's Guide and Operating 
Procedures, GA2 1-9370 

• IBM 5394 Remote Control Unit Operator's Guide and Problem 
Determination Procedures, GA27-3805 

• Attaching Work Station and Communications Cables, SA2 1-9957 

The coordinator for your IBM host system should also be able to 
supply a list of books for the host system. You should refer to this 
list for any additional books you may require. 



Terminology 

The following terminology is used throughout this manual: 
Term Meaning 

adapter An adapter that is a member of the IBM 5250 

Emulation Family 

cable A cable that attaches the adapter to the host 

cabling system 
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Emulation Program The Enhanced 5250 Emulation Program 
Version 2.4 

host IBM System/36, IBM System/38, IBM AS/400 

ISA bus Industry Standard Architecture bus: PC AT, 

ISA, or EISA bus 

personal computer IBM Personal Computer, IBM Portable 

Personal Computer, IBM Personal Computer 
XT,* IBM Personal Computer XT 286, IBM 
Personal Computer AT,* personal computers 
that have PCMCIA Type II or Type III slots, 
PS/1 personal computers, PS/2 personal 
computers, PSA/P personal computers, and 
other IBM compatible personal computers 

PS/1 Any model of the IBM Personal System/1* 

computer 

PS/2 Any model of the IBM Personal System/2* 

computer, including non-Micro Channel and 
Micro Channel bus computers from the PS/2 
family 

PS/VP Any model of the IBM PS/VaiuePoint* 

computer 

PC Personal computer 

Technical Reference manual 

Enhanced 5250 Emulation Program Version 
2.3 Technical Reference 

Note: All references to the IBM 5224 Printer are also valid for the 
IBM 5225 Printer. 
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Summary of Changes 



The following functions were changed or were added to the 
Emulation Program: 

• A procedure called INSTALL was added to the Emulation 
Program to replace the previous installation method. 

• Chapter 1, "Quick Start Instructions for the Emulation Program," 
was added to provide an overview of how to install, configure, 
and start the Emulation Program. The chapter is intended for 
people who are using the basic functions that the Emulation 
Program provides for communicating with a host system. 

For ISA bus personal computers: Because of the above 

installation changes, all users who have existing session 
profiles from Version 2.12 or later must run the 
configuration program (CONFIG) to update their existing 
session profiles to Version 2.4. 

For Micro Channel and PCMCIA bus personal computers: 

Session profiles before Version 2.3 are not compatible 
with the 5250 Emulation Adapter/A or the 5250 Emulation 
PCMCIA Adapter. All users who have existing session 
profiles from Version 2.3 must run the configuration 
program (CONFIG) to update their existing session 
profiles to Version 2.4. 

• In addition to support for IBM 3196 monochrome display 
emulation, the Emulation Program now supports IBM 3197 color 
display emulation. IBM 5292 Model 2 display emulation (host 
graphics) is no longer supported. 

• The Emulation Program now supports the following additional 
printers: 

- IBM 2380 Plus Printer 

- IBM 2381 Plus Printer 

- IBM 2390 Plus Printer 

- IBM 2391 Plus Printer 

- IBM 4037 5E Printer 

- IBM 4039 Printer 
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- IBM 4070 IJ Printer 

- IBM 4076 ExecJet* II 

- HP LaserJet 4 

Note: Printer Function Tables for the above printers are shipped 
with the Emulation Program. 

• The Emulation Program now supports the following host to 
personal computer code page translations: 



Host Code Page 


Personal Computer 
Code Page 


037 


437 


037 


850 


277 


850 


278 


850 


280 


850 


284 


850 


285 


850 


297 


850 


500 


437 


500 


819 


500 


850 


871 


819 


871 


850 


875 


869 


1026 


857 



• DOS Shell and other DOS graphics applications are now 
supported running in the DOS session using a CGA or a VGA 
monitor. 
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• The Emulation Program now supports improved keyboard 
functions in applications, like DisplayWrite/36 and OfficeVision,* 
that use Alt key combinations to perform functions like centering 
and bold. For example, pressing Alt+B to turn bold on. 

• The Emulation Program now supports Alternate Graphics 
keyboard characters. 
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Chapter 1. Quick Start Instructions for the 
Emulation Program 



This chapter contains quick start instructions for installing, 
configuring, and using the Emulation Program. For more detailed 
instructions, see Chapter 3, "Detailed Installation and Configuration." 

Some knowledge of your personal computer, IBM Disk Operating 
System (DOS), IBM 5250 Information Display System, and your host 
system is required. This chapter does not show you how to use the 
host functions. 

Note: If your personal computer is not attached to a host system, 
refer to Chapter 2, "Getting Ready for 5250 Emulation." Do not 
attempt to attach your personal computer to a host system without 
proper authorization and instructions. 



Emulation Program Overview 

The Emulation Program lets your personal computer emulate 5250 
display stations and printers. The adapter and this program allow 
your personal computer to perform the functions of one or two 
workstations at the same time on one cable. The workstations can 
be defined as one display, two displays, or one display and one 
printer. 

You can move between your two emulated sessions and between 
the host sessions and the personal computer session by pressing a 
defined hot key sequence. 

Each display session or printer session uses a unique workstation 
address to communicate to the host. 

Before you can run the Emulation Program, you must: 

• Install and configure your IBM 5250 Emulation Family adapter 

• Install and configure the Emulation Program 

Note: Before you install the Emulation Program, make a backup 
copy of the program diskette. 
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Installing and Configuring Your Adapter 

For information about configuring your adapter, see "Configuring the 
Adapter" on page 3-15. For adapter installation and configuration 
instructions, see the Guide to Operations or Installation and Test 
Instructions manual that was provided with your adapter. 

Installing and Configuring the Emulation Program 

Before you can use the Emulation Program, you must install and 
configure it. Configuring the Emulation Program includes specifying 
the adapter that you are using and providing the information that is 
needed for your 5250 sessions. 

1. To install the Emulation Program, run the installation program 
(INSTALL) using the instructions in "Quick Start Installation of the 
Emulation Program" on page 1-4. For more detailed 
instructions, see Chapter 3, "Detailed Installation and 
Configuration." 

2. To specify the type of adapter that you are using, run the 
adapter selection program (HWCONFIG). This program 
automatically starts when the INSTALL program ends. You can 
also start this program by entering HWCONFIG at the DOS 

ni"/"\nrir»+ in tho omi iloti/-»r> r\\rar*tr\r\i Cnr ii-ic>+ri i /->+!/-» ne eoQ "I leir»/*i 
jjiumi|ji iii ii iK3 ui i iuiuiivi i viii Oi/Wi y . ■ yi iiioiiuv/uuno, occ won iu 

the Adapter Selection Program" on page 3-1 1 . 

3. To specify information about the 5250 emulation sessions (for 
example, number of sessions, display or printer emulation, and 
station addresses), run the session configuration program 
(CONFIG) using the instructions in "Creating a Basic Session 
Configuration" on page 1 -6. For more detailed instructions, see 
"Configuring for Emulation" on page 3-25. 

For more information about the installation and configuration 
programs, see Chapter 3, "Detailed Installation and Configuration." 

For information about using the Emulation Program with OS/2, see 
"Using the Emulation Program with OS/2" on page 3-36. 

Note: To run the Emulation Program, you might also need to 
specify or change the configuration of your adapter. For information 
about adapter configuration, see "Configuring the Adapter" on 
page 3-15. 
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What You Need 

• Personal computer (as defined in "Terminology" on page xxiii) 

• Personal computer attached printer, if emulating a printer session 
(For a list of supported personal computer printers, see "Printer 
Session Requirements" on page 2-3.) 

• A monochrome or color display (with the appropriate adapter, if 
necessary) that is designed to the Color Graphics Adapter 
(CGA), Enhanced Graphics Adapter (EGA), or Video Graphics 
Array (VGA) standard or better 1 

• One 5.25-inch diskette drive (1.2MB) or one 3.5-inch diskette 
drive (1 .44MB) (and adapter, if required) 1 

• One of the following IBM 5250 Emulation Family adapters: 

- Enhanced 5250 Display Station Emulation Adapter (for IBM 
PC AT, ISA, and EISA bus personal computers) 

- 5250 Emulation Adapter/A (for Micro Channel bus personal 
computers) 

- 5250 Emulation PCMCIA Adapter (for personal computers 
that are equipped with PCMCIA Release 2.0 Type II or III 
slots) 

• 128KB or more memory to load the Emulation Program 

• 128KB or more memory to run the Installation Program 

• IBM Disk Operating System (DOS) Version 5.0 or later 

• Emulation Program diskettes for your adapter 1 

• If using OS/2, OS/2 Version 2.1 or later 



For Micro Channel bus personal computers: You need a monitor designed to 
VGA standard or better, an adapter cable (purchased separately), an 
Options Diskette, and a 3.5-inch diskette drive (1.44MB). 

For PCMCIA bus personal computers: You need a monitor designed to VGA 
standard or better, an adapter cable (purchased separately), an 
Enabler/Diagnostic Diskette, and a 3.5-inch diskette drive (1 .44MB). 
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You also need to ask your host system planner for a workstation 
address for each of your sessions. 



Quick Start Installation of the Emulation Program 

1 . Insert the program diskette into the A: drive. 

2. At the DOS prompt, type A: and press Enter. 

3. Type INSTALL and press Enter. The screen shown in 
Figure 1-1 appears. 




Enhanced 5256 Emulation Program 
Version 2.4 

(c) Copyright IBM Corp. 1994. All rights reserved. 
US Government Users Restricted Rights - 
Use, duplication or disclosure 
restricted by GSA ABP Schedule 
Contract with IBM Corp. 



Press [Esc] to quit, any other key to continue ... 



Figure 1-1. Install Logo Screen 

The install program guides you through a series of screens that 
ask for different option settings. 

4. Type the options you want and press Enter. 

Note: The default emulation subdirectory is C:\EM5250. You 
might need to change the drive name for your system. If you are 
upgrading from Version 2.3, you can install into the same 
subdirectory where the 5250 emulation files are currently located. 

At the end of the installation process, the adapter selection 
program (HWCONFIG) automatically starts. 
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5. From the Adapter Selection screen, shown in Figure 1-2, select 
the adapter that is installed on the personal computer. 



Adapter Selection 
for the Enhanced 5258 Emulation Program 



-1- IBM Enhanced 5256 Emulation Adapter 
for IBM PC, ISA, and EISA systems 

-2- IBM 5256 Emulation Adapter/A 
for IBM Micro Channel systems 

-3- IBM 5256 Emulation PCMCIA Adapter 

Use the up and down arrow keys to select the 5258 emulation adapter 
installed in your system. To save your adapter selection, Press F3 and then 
select Option 1 on the exit screen. For configuration information about 
your adapter press F6. 



t*=Select Fl=Help F3=Exit F6=Adapter Configuration 



Figure 1-2. Adapter Selection Screen 

6. Exit the adapter selection program and save the adapter 
configuration. For more information about configuring your 
adapter, see "Configuring the Adapter" on page 3-15. 

Note: If you receive an error message when you start the 
Emulation Program, see "Adapter Conflicts" on page 3-22 for 
information about resolving conflicts between the adapter and 
either memory or other adapters that are installed in your 
personal computer. 

For information about changing the default I/O address, interrupt 
level, or card address, see "Configuring the Enhanced 5250 
Display Station Emulation Adapter" on page 3-16, "Configuring 
the 5250 Emulation Adapter/A" on page 3-22, or "Configuring the 
5250 Emulation PCMCIA Adapter" on page 3-22. 

Installation of the Emulation Program is complete. Remove the 
program diskette and store it in a safe place. 
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Creating a Basic Session Configuration 



This section takes you through the basic steps of creating a session 
profile. These steps assume you are emulating a 3196 display and a 
5219 printer. You can also emulate 3197 displays, a 5256 printer, or 
a 5224 printer. For detailed session configuration instructions, see 
"Running the Session Configuration Program" on page 3-26. 

For information about advanced options and features, like automatic 
screen dimming, see Chapter 11, "Advanced Configuration." 

Before you run the session configuration program, ask the host 
system administrator for a unique workstation address between 0 
and 6 for each session (display or printer). You must enter these 
addresses during the configuration process. 
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Before doing the following steps, make sure you are in the emulation 
directory. 

1 . At the DOS prompt, type CONFIG and press Enter. The 
configuration logo screen, shown in Figure 1-3, appears. 




Session Configuration 
Enhanced 52S8 Emulation Program 
Version 2.48 

(C) Copyright IBM Corp. 1985, 1994. All rights reserved. 



Press •«— 1 (Enter) to continue 



Figure 1-3. Configuration Logo Screen 

Read the information screens and press Enter until you get to 
the Set Number of Sessions screen. 

2. From the Set Number of Sessions screen, type 2 and press 
Enter. 

3. From the Language Selection screen, select your language by 
typing the number that is next to the language you want and 
pressing Enter. The language that you select determines which 
keyboard customization file is used and other language-specific 
information that is reported to the host. 

4. From the Keyboard Selection Menu, select the keyboard that is 
attached to your personal computer. Select the enhanced 
keyboard for laptop computers. For a list of the keyboard 
customization files, see Figure E-2 on page E-4. 
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5. From the Select Host to PC Display Code Page Mapping screen, 
select the mapping that matches the host and personal computer 
code pages you are using and press Enter. 

6. From the Primary Workstation Address screen, enter the 3196 
display device address for session 1; enter the 5219 printer 
address for session 2. 

7. From the Select Session 2 Type screen, type 2 for the 5219 
printer and press Enter. 

8. From the Attached Printer List screen, select the type of printer 
that is attached to your personal computer and press Enter. 

Note: If your printer is not in the attached printer list, specify a 
Printer Function Table (PFT) for a table-driven printer. For a list 
of PFTs, see "Printer Function Table Files" on page D-2. 

9. From the Select Host to Printer Code Page Mapping screen, 
select the mapping that matches the host and printer code pages 
that you are using and press Enter. 

10. From the Advanced Options Menu screen, select Save data 
profile (1) and press Enter. 

11. From the Save Profile Data screen, press Enter. DP5250.DAT is 
the default fiie name for the profile. 

12. From the Advanced Options Menu, select Quit (2) and press 
Enter. 

You have completed the basic session configuration. 
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Starting the Emulation Program 

To start the Emulation Program: 

1. Make sure you are in the emulation directory. 

2. Type DP5250 and press Enter. A pre-signon screen appears. 

3. Press any key to continue. 

When the personal computer comes online with the host, an alarm 
sounds and the pre-signon screen is replaced with a host screen. 

Note: You can run the Emulation Program in an OS/2 Version 2.1 
DOS session. For information about using the Emulation Program 
with OS/2, see "Using the Emulation Program with OS/2" on 
page 3-36. 



Using an Emulated Session 

This section provides basic information about using the Emulation 
Program. For more detailed information, see later chapters in this 
manual. 

Hot Key Sequence 

To toggle between the host sessions and the DOS session, press 
the hot key sequence: Alt+Esc 

Status Line 

Line 25 of the display session screen shows the status of the host 
and the personal computer. The status line has the following basic 
indicators: 



rr-cc 


Cursor Location, where rr is the row number and cc is the 




column number 


SA 


System Available 


MW 


Message Waiting 


KS 


Keyboard Shift 


IM 


Insert Mode 
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II Input Inhibited 

Sn Session Number, where n is the number of the session 
KB Keystroke Buffering 

Note: When the indicator is displayed in reverse video, the indicator 
is on. 

Keyboard Definition 

The key definitions for an emulated session are not exactly the same 
as marked on the keyboard. For illustrations of the supported 
keyboard layouts for the enhanced style keyboard, see "Keyboard 
Layouts" on page E-5. 



Ending the Emulation Program 

Warning: Do not end the Emulation Program while running an 
application program in the DOS environment. 

To end the Emulation Program and remove it from memory: 

1 . Sign off from the host. 

2. When a host signon screen appears, press Ctrl+Alt+Del. This 
ends the Emulation Program, releases the memory it used, and 
returns you to the DOS prompt. 

For information about ending the Emulation Program when you are 
using OS/2, see "Ending the Emulation Program under OS/2" on 
page 3-38. 
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Chapter 2. Getting Ready for 5250 Emulation 



This chapter is for the person who plans for your host system and for 
the attachment of the personal computer to the host system. Other 
parts of the manual provide information about installing and using the 
Emulation Program. 

Warning: Do not attempt to attach your personal computer to a host 
system without proper authorization and instructions. 



Host Hardware and Software Requirements 

The host computer can be one of the following: 

• IBM System/36 

• IBM System/38 

• IBM AS/400 

The personal computer can be connected to a host computer 
through one of the following remote workstation control units: 

• IBM 5294 Remote Workstation Control Unit 

• IBM 5394 Remote Workstation Control Unit 

• IBM 5494 Remote Workstation Control Unit 

Appropriate cables and connectors are also required. For 
information about connecting workstations, see "Arranging the 
Workstations" on page 2-8. 

The following additional software products might be required: 

• If your host system is an IBM System/36 (5360 System Unit 
or 5362 System Unit), you must use Release 5 Modification 
Level 1 or later of the System Support Program (5727-SS1). 

• If your host system is an IBM System/36 (5364 System Unit), 
you must use Release 5 Modification Level 1 or later of the 
System Support Program (5727-SS6). 
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• If your host system is an IBM System/38, you must use 
Release 8 or later of the Control Program Facility (5714-SS1) 
with Program Change 'C (PC'C). 

• If your host system is an IBM AS/400, you must use Release 1 
or later of the Operating System/400* Program (5728-SS1). 



Personal Computer Hardware and Software 
Requirements 

The minimum requirements for your personal computer are: 

• One of the following IBM 5250 Emulation Family adapters: 

- Enhanced 5250 Display Station Emulation Adapter (for IBM 
PC AT, ISA, and EISA bus personal computers) 

- 5250 Emulation Adapter/A (for Micro Channel bus personal 
computers) 

- 5250 Emulation PCMCIA Adapter (for personal computers 
that are equipped with PCMCIA Release 2.0 Type II or III 
slots) 

Note: For information about the hardware requirements for your 
IBM 5250 Emulation Family adapter, see the Installation and 
Test Instructions or the Guide to Operations that was provided 
with your adapter. 

• IBM Disk Operating System (DOS) Version 5.0 or later 

• If using OS/2, OS/2 Version 2.1 or later 

• One 5.25-inch 1.2MB diskette drive or one 3.5-inch 1.44MB 
diskette drive 

• Enough memory to run the Emulation Program and your 
application programs. For information about memory 
requirements, see "Memory Requirements" on page 2-4. 

For more information about session requirements, see "Display 
Session Requirements" on page 2-3 and "Printer Session 
Requirements" on page 2-3. 
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Display Session Requirements 

For a display session, you need a monochrome or color display (with 
the appropriate adapter, if necessary) that is designed to the CGA, 
EGA, or VGA standard or better. 

Printer Session Requirements 

If you are using a printer session, one of the following is required: 



IBM 


2380 


Personal Printer 


IBM 


2380 


Plus Personal Printer 


IBM 


2381 


Personal Printer 


IBM 


2381 


Plus Personal Printer 


IBM 


2390 


Personal Printer 


IBM 


2390 


Plus Personal Printer 


i n i\ a 

IBM 


2391 


Personal Printer 


IBM 


2391 


Plus Personal Printer 


i r> i\ a 

IBM 


3812 


Pageprinter 


IBM 


4016 


Exec Jet II Printer 


IBM 


4019 


Laser Printer 


IBM 


4029 


Laser Printer 


IBM 


4037 


5E Printer 


IBM 


4039 


Laser Printer 


IBM 


4070 


IJ Printer 


IBM 


4072 


ExecJet Printer 


IBM 


4201 


Proprinter* 


IBM 


4202 


Proprinter XL 


IBM 


4207 


Proprinter X24 


IBM 


4208 


Proprinter XL24 


IBM 


4212 


Proprinter 24P 


IBM 


4226 


Printer 


IBM 


5152 


■1 Matrix Printer 


IBM 


5152 


■2 Graphics Printer 


IBM 


5182 


Color Printer 


IBM 


5201 


Quietwriter* 


IBM 


5202 


Quietwriter III 


IBM 


5204 


Quickwriter* 
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• IBM 5216 Wheelprinter 1 

• HP LaserJet Printer Series II Printer 

• HP LaserJet Printer Series III Printer 

• HP LaserJet Printer Series IV Printer 

• User-defined printer 

Note: To support user-defined printers, additional memory is 
required. For more information about user-defined printers, see 
Chapter 10, "Using the Printer Function Table Setup Program." 

Memory Requirements 

To ensure that your Emulation Program and application programs 
can run at the same time, plan for the memory requirements of your 
personal computer. 

The maximum amount of memory that you need is 128K. The 
amount of memory that you need to do each of the following is: 

• To load the Enhanced 5250 Emulation Program, at least 128KB 
of memory is required. 

• To run the configuration program, at least 128KB of memory is 
required 

• To run the installation program, at least 128KB of memory is 
required. 

• To configure one or two display sessions, at least 40KB of 
memory is required. 

• To configure one display session and one printer session, at 
least 76KB of memory is required. 

Memory requirements for DOS vary with the version used and are in 
addition to any other personal computer memory requirements. For 
the memory requirements of the DOS version and the application 
programs that you plan to use, see to the manuals provided with the 
DOS and application software. 



1 You must install a parallel or serial attachment interface on the 5216 printer before 
connecting it to the personal computer. 
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For more information about memory requirements, see "Printer 
Session Requirements" on page 2-3 and "Planning for Using 
Program Applications" on page 2-16. 



Attaching to the Host 

Attaching your personal computer to the host requires careful 
planning. This planning includes making decisions about how and 
where to connect your personal computer. The person who is 
responsible for the physical planning of the host should be involved 
in planning the connection of your personal computer, the installation 
of the adapter, and the installation of the Emulation Program. 

When attaching your personal computer to a host, you need to 
consider the number of workstations and how to cable them. 

Workstations 

Each personal computer must have a workstation address for each 
session that it uses. Each address used by a display session or a 
printer session is counted as one of the allowed workstations on a 
line: 

• On a local workstation line, you can connect a maximum of 
seven workstations in series. 

• On an IBM 5294 Remote Control Unit, you can connect a 
maximum of eight workstations or personal computers. 

• On an IBM 5394 Remote Control Unit, you can connect a 
maximum of 16 workstations or personal computers. 

• On an IBM 5494 Remote Control Unit, you can connect a 
maximum of 28 workstations or personal computers. 

For information about addressing workstations, see "Addressing 
Workstations" on page 2-9. 
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Cabling 

For information about device arrangement, see "Arranging the 
Workstations" on page 2-8. 

Using Twinaxial Cabling 

When using twinaxial cabling, the following rules apply: 

• When attaching a workstation to the workstation line, the 
minimum distance between two Integrated Cable Assemblies is 
1 meter (3.3 feet). 

• Any workstation line can have a maximum of 1 1 junctions. Each 
display, printer, personal computer, cable splice, or station 
protector is a junction. 

• If the last workstation on a line (other than a personal computer) 
does not have the Cable Thru feature, it must remain the last 
workstation on that line. 

• The maximum cabling distance between the host and the last 
workstation or personal computer on a twinaxial cable is 
1525 meters (5000 feet). 

Using Unshielded Twisted Pair Cabling 

When using unshielded twisted pair cabling, the following rules apply: 

• The maximum distance between the host and the 5299 or any 
workstation is 1 000 feet. 

• The maximum distance between the 5299 and any workstation is 
900 feet. 

When twinaxial cabling is used between the host and the 5299, the 
following rules apply: 

• The maximum distance between the host and the 5299 or any 
workstation is 2000 feet. 

• The maximum distance between the 5299 and any workstation is 
900 feet. 
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Using the IBM Cabling System 

When using the IBM Cabling System (ICS), the maximum 
"equivalent" distance between the host and the last workstation on 
the ICS cable is 5000 feet. 

To calculate the "equivalent" distance, use the formula: a+Zb+l.Sc 
where: 

a Is the actual length of type 1 or type 2 cable 

b Is the actual length of type 8 cable 

c Is the actual length of type 6 or type 9 cable 



Configuring the Host for the Emulation Program 

When you configure the host for the Emulation Program, enter the 
following device types: 



Figure 2-1. Device Codes 


Type of 
Emulation 


Device Type 


Keyboard Type 


Display 


3196 


Enhanced 


Display 


3197 


Enhanced 


Printer 


Any combination of 5219, 
5224, 5225, or 5256 


Not applicable 



Note: When you convert session profiles from Version 2.12 or later 
of the Emulation Program for use with Version 2.4, any 5292 display 
sessions are changed to 3197 display sessions. You might need to 
adjust the workstation address and the host device description for 
these sessions. For more information about converting session 
profiles, see "Converting 2.12 or Later Profiles to 2.4 Level" on 
page 3-38. 
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In the S/36 environment: You must configure your text display with 
an enhanced keyboard. Select "change device 
characteristics" on your configuration screen to select the 
enhanced keyboard for your display device description. 

If you are upgrading from Version 2.3 or earlier of the 
Emulation Program, you must reconfigure your display device 
description for an enhanced keyboard. 



Arranging the Workstations 

To determine the device arrangement that meets your needs, look at 
a cabling diagram for your host. 

For local attachment, the twinaxial cables that connect the devices to 
the host are shown in Figure 2-2. 




Figure 2-2. Local Attachment of Workstations 
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For remote attachment, the personal computer connects to the host 
through a communications link. For a 5294, the twinaxial cables that 
connect the devices are shown in Figure 2-3. 




Addressing Workstations 

A workstation device can be either a display or a printer. The host 
does not allow displays and printers to share the same address. 
Each address must be defined as either a display or a printer. 
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The session configuration program assigns a single address for the 
primary (first display) session, but you can add up to six other 
addresses from the Advanced Display Emulation Options screen. 
For information about creating a workstation address list, see 
"Workstation Address List" on page 11-6. The first address should 
be a unique address for the primary display session of each device 
on the line. 

The session configuration program lets you enter a list of addresses 
(that is, an address search list) for the second session. The 
Emulation Program listens to the line and searches the list for the 
first address that is not being used by another workstation. The 
addresses on the list for the personal computers on a line should be 
rotated to reduce the chance of an address conflict. For examples of 
how to rotate addresses, see "Example 1" on page 2-12 and 
"Example 2" on page 2-13. 

To assign two display sessions or a display session and a printer 
session to each personal computer, you would need three unique 
addresses. By sharing the address for the second session of each 
personal computer, you can have six personal computers on each 
line. This is done with the address search list for the second 
session. 

The second session of the Emulation Program can have up to six 
addresses in a search list. If the program has a list of addresses 
assigned to it and the program attempts to come up, it might use the 
address assigned to some other 5250 Information Display System 
compatible device. To prevent this, each device on the line should 
be assigned a unique address for its first session — an address that is 
only responded to by that device. By doing this, each device always 
has access to at least one session on the host. 
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You can use two session profiles. Both profiles would use the first 
session as a display session. The first profile would use an address 
list for a display for its second session. (For an example, see 
"Example 1" on page 2-12.) The second profile would use an 
address list for a printer for its second session. (For an example, 
see "Example 2" on page 2-13.) The addresses for the second 
session can be shared with other Enhanced Emulation Programs on 
the line. 

See "Data Security" on page xvi for data security information 
concerning address lists. 

Notes: 

1 . The Emulation Program selects the first available address in the 
list you provide. 

2. When configuring your Emulation Program, do not mix display 
and printer addresses in the same address list. 

3. If two workstations attempt to use the same address at the same 
time, the host does not communicate with either of them. 
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Example 1 

This example shows four attached personal computers. Station 
addresses 0 through 5 are configured as displays on the host. 
Address 6 is configured as a printer. This example is discussed in 
"Addressing Workstations" on page 2-9. 



Workstation/Session 


Address(es) 


personal computer #1 




first display 


0 


occumu uib|jicty 


4, O 


printer 


6 


personal computer #2 




first display 


1 


second display 


5, 4 


printer 


6 


personal computer #3 




first display 


2 


second display 


4,5 


printer 


6 


personal computer #4 




first display 


3 


second display 


5,4 


printer 


6 
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Example 2 

This example shows three personal computers and a 3196 display 
attached. Station addresses 0 through 4 are configured as displays 
on the host. Addresses 5 and 6 are configured as printers. This 
example is discussed in "Addressing Workstations" on page 2-9. 

Note: A personal computer cannot use the address assigned to the 
3196 display. 



Workstation/Session 


Address(es) 


personal computer #1 




first display 


0 


second display 


4 


printer 


5, 6 


personal computer #2 




first display 


1 


second display 


4 


printer 


6, 5 


personal computer #3 




first display 


2 


second display 


4 


printer 


5, 6 


display unit 




3196 


3 



Emulation Adapter 

If the memory segments, I/O port spaces, or interrupt level of your 
emulation adapter conflicts with other installed adapter cards, you 
can change the memory segments, I/O port address, or interrupt 
level that the emulation adapter uses. 

For detailed information about installing and configuring an IBM 5250 
Emulation Family adapter, follow the directions in the Guide to 
Operations or the Installation and Test Instructions provided with the 
adapter. For information about the adapter configuration programs, 
see "Configuring the Adapter" on page 3-15. 
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For ISA bus personal computers: When you receive the 

Enhanced 5250 Display Station Emulation Adapter from the 
factory, the I/O address switches are set at the default 
address of hexadecimal 2718-271 F. (Switches 1 and 6 set 
ON, and all others set OFF. To verify the settings, see the 
Installation and Test Instructions or the Guide to Operations 
manual that was provided with your adapter.) I/O addresses 
2718 through 271 F are used with the default setting. 

If you change the setting of the switches on the adapter card, 
you must run the hardware configuration program 
(HWCONFIG) to update the I/O address in the hardware 
configuration profile. For more information about changing 
the hardware configuration, see "Configuring the Enhanced 
5250 Display Station Emulation Adapter" on page 3-16. 

For Micro Channel bus personal computers: Use the Set 

Configuration option on the reference diskette to change the 
configuration. 

For PCMCIA bus personal computers: You must first install the 
necessary software from the En abler/Diagnostic Diskette that 
was provided with the adapter. Use the SETUP program on 
the Enabler/Diagnostic Diskette to install the software. After 
you install the PCMCIA software, run the CFG5250 program 
to change the configuration of the adapter. 

It is recommended that you use the PCMCIA Card Services 
and Socket Services configuration option. For additional 
information about setting the configuration, see Appendix C, 
"PCMCIA Setup Considerations" or the Installation and Test 
Instructions manual that was provided with your adapter. 
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Planning for Implementation 
Planning for Using DOS 

The Emulation Program can run under the Disk Operating System 
(DOS), Version 5.0 or later. 

If your personal computer does not support interrupt sharing, make 
sure that the interrupt level for the emulation adapter is not used 
elsewhere in your system. 

Planning for Using the DOS Shell Option 

If you are using the DOS Shell option, the following guidelines should 
be followed for emulation: 

• The Emulation Program must be started before the DOS Shell. 

• The DOS Shell must be ended before ending the Emulation 
Program. Otherwise, malfunctions might occur. 

• Supported mouse drivers are: 

- IBM PS/2 Mouse Program Version 1.10 or higher 

- Microsoft** Mouse Driver Version 8.0 or higher 

- Any mouse driver that is compatible with the drivers listed 
above 

• When using an IBM PS/2 Mouse attached to an IBM PS/2 
Model 30 286, the mouse must be attached before turning on 
the personal computer. The DOSSHELL.BAT file must include 
the driver PCIBMDRV.MOS. The mouse program 
(MOUSE.COM) must be executed before loading the Emulation 
Program. This should be taken into consideration when setting 
up your AUTOEXEC.BAT file. 

• If an IBM PS/2 Mouse is not attached to the IBM PS/2 
Model 30 286, you must remove the PCIBMDRV.MOS driver 
from the DOSSHELL.BAT file. 
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Planning for Using OS/2 

If you are using the Emulation Program in an OS/2 DOS session: 

• Version 2.1 of OS/2 is required. 

• You cannot use the DOS session while running the Emulation 
Program. Entering any DOS command except EXIT (to end the 
Emulation Program) can cause unpredictable results. 

Note: Interrupt sharing is not supported when using the Emulation 
Program under OS/2. 

Planning for Using Program Applications 

The Emulation Program works with most DOS applications. 
However, some programs, such as one that overlays the Emulation 
Program, are not compatible. 

For more information about planning for memory requirements, see 
"Memory Requirements" on page 2-4. 

Understanding the Session Profile 

The session profile contains the parameters that your personal 
computer needs to communicate with the host and to operate the 
Emulation Program: 

• Display station emulation parameters 

• Workstation session parameters 

• Personal computer hardware parameters 

• Printer parameters 

The Emulation Program will not start until a session profile exists. If 
you do not have a session profile, make one by running the 
configuration program (CONFIG.EXE) that is provided on the 
program diskette. The configuration program provides menus to help 
you make selections. 

Note: When you convert session profiles from Version 2.12 or later 
of the Emulation Program for use with Version 2.4, any 5292 display 
sessions are changed to 3197 display sessions. You might need to 
adjust the workstation address and the host device description for 
these sessions. For more information about converting session 
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profiles, see "Converting 2.12 or Later Profiles to 2.4 Level" on 
page 3-38. 

The configuration program saves the session profile on the disk. 
The session profile is used to configure your personal computer 
when the Emulation Program is loaded. 

For brief instructions for running the configuration program, see 
"Creating a Basic Session Configuration" on page 1-6. For more 
detailed instructions, see "Configuring for Emulation" on page 3-25. 

Using Signon Passwords 

You might need a password to sign on to your host system. If you 
need a password, see the person who provides access to the host 
system. 



Chapter 2. Getting Ready for 5250 Emulation 2-1 7 



2-18 Enhanced 5250 User's Guide 



Chapter 3. Detailed Installation and 
Configuration 

This chapter provides information about: 

• Installing and configuring the Emulation Program 

• Configuring your IBM 5250 Emulation Family adapter 

• Resolving adapter conflicts, including how the IBM 5250 
Emulation Family adapters use memory 

• Using the Emulation Program with OS/2 

• Converting Version 2.12 or later session profiles to Version 2.4 

Note: If your personal computer is not attached to a host system, 
refer to Chapter 2, "Getting Ready for 5250 Emulation." Do not 
attempt to attach your personal computer to a host system without 
proper authorization and instructions. 



Emulation Program Overview 

The Emulation Program lets your personal computer emulate 5250 
display stations and printers. The adapter and this program allow 
your personal computer to perform the functions of one or two 
workstations at the same time on one cable. The workstations can 
be defined as one display, two displays, or one display and one 
printer. 

You can move between your two emulated sessions and between 
the host sessions and the personal computer session by pressing a 
defined hot key sequence. 

Each display session or printer session uses a unique workstation 
address to communicate to the host. 

Before you can run the Emulation Program, you must: 

• Install and configure your IBM 5250 Emulation Family adapter 

• Install and configure the Emulation Program 
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Installing and Configuring Your Adapter 

For information about configuring your adapter, see "Configuring the 
Adapter" on page 3-15. For adapter installation and configuration 
instructions, see the Guide to Operations or Installation and Test 
Instructions manual that was provided with your adapter. 

Installing and Configuring the Emulation Program 

Before you can use the Emulation Program, you must install and 
configure it. Configuring the Emulation Program includes specifying 
the adapter that you are using and providing the information that is 
needed for your 5250 sessions. 



For a description of the installation and configuration programs, see 
Figure 3-1. 



Figure 3-1 (Page 1 of 2). Emulation Program Installation and 
Configuration Programs 


Installation Program 


Program: 


INSTALL 


Source: 


IBM Enhanced 5250 Emulation Program Diskette 


Purpose: 


Installs the IBM Enhanced 5250 Emulation Programs 
from the diskettes to your personal computer's hard disk. 


Adapter Selection Program 


Program: 


HWCONFIG 


Source: 


Installed on your personal computer by the INSTALL 
program, which is described above 


Purpose: 


Specifies the type of adapter that is to be used for 5250 
Emulation. The adapters that you can use with the 
Emulation Program are the Enhanced 5250 Display 
Station Emulation Adapter, the 5250 Emulation 
Adapter/A, and the 5250 Emulation PCMCIA Adapter. 

Note: The INSTALL program automatically starts this 
program. You can also start the program by entering 
HWCONFIG at the DOS prompt of the emulation 
directory. 
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Figure 3-1 (Page 2 of 2). Emulation Program Installation and 
Configuration Programs 


Session Configuration Program 


Program 


CONFIG 


Source: 


Installed on your personal computer by the INSTALL 
program, which is described above 


Purpose 


Specifies 5250 Emulation Session information, such as 
the number of sessions, the type of emulation, and the 
station address used by each session 



To install the Emulation Program, follow the directions in "Installation 
Program." For quick start instructions, see Chapter 1. 

To specify which adapter the Emulation Program is to use, follow the 
instructions in "Using the Adapter Selection Program" on page 3-11. 

To configure the Emulation Program for session emulation, follow the 
directions in "Configuring for Emulation" on page 3-25. For quick 
start directions, see "Creating a Basic Session Configuration" on 
page 1-6. 

Note: Before running the Emulation Program, you might also need 
to specify or change the configuration of your adapter. For 
information about adapter configuration, see "Configuring the 
Adapter" on page 3-15. 



Installation Program 

The INSTALL program, which is provided for installing the Emulation 
Program: 

• Copies the files for basic emulation 

• Copies the files for keyboard support 

• Copies the files for using Printer Function Tables 

• Copies the Sample Emulation Program Utilities 

Each screen of the installation program includes questions for you to 
answer and information about how to answer the questions. 

Note: The installation program requires at least 128KB of memory. 
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In addition to the files that the INSTALL program copies from the 
Enhanced 5250 Emulation Program diskettes, the 5250 Emulation 
Adapter/A and the 5250 Emulation PCMCIA Adapter require the 
installation of configuration files that are provided with the adapters. 

For 5250 Emulation Adapter/A: The 5250 Emulation Adapter/A 
requires configuration files that are provided with your 
adapter on the Option Diskette. 

To install the necessary files onto your personal computer, 
use your System Reference diskette and select Copy an 
option diskette. For more information about configuring the 
adapter, see the Installation and Test Instructions manual that 
was provided with your adapter. 

For 5250 Emulation PCMCIA Adapter: The 5250 Emulation 

PCMCIA Adapter requires configuration files that are provided 
with your adapter on the Enabler/Diagnostic Diskette. To 
install the necessary files onto your personal computer, run 
the SETUP program before running the installation program. 
For more information about configuring the adapter, see 
Appendix C, "PCMCIA Setup Considerations," or the 
Installation and Test Instructions manual that was provided 
with your adapter. 

There is a README.DOC file on the installation diskette that 
contains additional information about using the Emulation Program. 
To print the README.DOC file, place the installation diskette into 
drive A, turn on your printer, and type: 
COPY A:README.DOC LPT1 
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Installing the Emulation Program 

To install the emulation files: 

1. Insert the program diskette into the A: drive. 

Note: Use a backup copy of the program diskette. For 
information about making backup diskettes using the DISKCOPY 
command, see the IBM Disk Operating System User's Guide and 
Reference. 

2. Type A:INSTALL 

The title screen, shown in Figure 3-2, appears. 




Enhanced 5250 Emulation Program 
Version 2.4 

(c) Copyright IBM Corp. 1994. All rights reserved. 
US Government Users Restricted Rights - 
Use, duplication or disclosure 
restricted by GSA AOP Schedule 
Contract with IBM Corp. 



Press [Esc] to quit, any other key to continue ... 



Figure 3-2. Installation Title Screen 

3. Press any key, and the Welcome to the Enhanced 5250 
Emulation Program screen appears. 
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4. Press any key to continue to the screen describing the two 
installation options. Please read this information and press any 
key to advance to the Installation Options Selection screen, 
shown in Figure 3-3. 



INSTALLATION OPTIONS SELECTION 

Select the desired installation option by using the arrow keys. 
Blinking text indicates the selected option. Press the Enter key 
to continue. 



Install Enhanced 5250 Emulation V2.4. 
Install additional drivers. 



Figure 3-3. Installation Options Selection 



5. Select the installation option that you want. If you are installing 
Version 2.4 for the first time, select the first option, "Install 
Enhanced 5250 Emulation V2.4." This option installs all the files 
necessary for emulation. The second option is provided in case 
you want to add additional keyboard support. When the 
selection is complete, press Enter to continue. 
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6. The Drive Selection screen, shown in Figure 3-4, appears next. 
This screen asks which drive you want to install the Emulation 
Program on. It lists only the hard drives that it detects in your 
personal computer. Use the arrow keys to scroll up and down in 
the box. When you get to the drive you want, press Enter to 
continue. 



DRIVE SELECTION 

Select the drive you would like to install 
Enhanced 5250 Emulation to by using the arrow keys to 
scroll up and down in the box. Blinking text indicates 
the selected drive. Press the Enter key to continue. 



Drive C: 



Figure 3-4. Drive Selection Screen 
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7. The Subdirectory Selection screen, shown in Figure 3-5, 
appears. Type the name of the subdirectory in which you want 
to install the files and press Enter to continue. If the directory 
does not already exist, the installation program creates it. 

Note: The default emulation subdirectory is \EM5250. You 
might need to change the drive name for your system. If you are 
upgrading from Version 2.3, you can install into the same 
subdirectory where the 5250 emulation files are currently located. 



SUBDIRECTORY SELECTION 

If you would like 5250 for DOS to install in a 
subdirectory other than the default directory, type it in 
now. Press the Enter key to continue. 



=The default is C:\ EM525G= 
\EM5250 



Figure 3-5. Subdirectory Selection Screen 
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8. The National Language Keyboards Information screen, shown in 
Figure 3-6, appears. This screen lists the keyboards that the 
Emulation Program supports. Press any key to display the 
National Language Keyboard Selection screen. Scroll to the 
languages that you want and press the space bar to select them. 
When finished, press Enter to continue. The keyboard 
customization files that are associated with each selected country 
are installed. 



NATIONAL LANGUAGE 


KEYBOARDS INFORMATION 


Enhanced 5258 Emulation version 2.4 supports a number of 


different National Language keyboards. This is a list of 


the supported countries. 






US 


Italian 




Belgian 


Latin American 




Brazilian 


Norwegian 




Canadian French 


Portuguese 




Danish 


Spanish 




Dutch 


Swedish/Finnish 


French 


Swiss-French 




German 


Swiss-German 




Greek 


Turkish 




Icelandic 


UK 




You may install as many as you like by using the spacebar 


to select or deselect each keyboard on the next screen. 


Press [Esc] to quit, any other key to continue ... 











Figure 3-6. National Language Keyboards Information Screen 
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9. Before the Emulation Program is installed, the Sample Memory 
Map screen, shown in Figure 3-7, appears. This screen shows 
how the adapter uses memory. 



SAMPLE MEMORY MAP 



EXTENDED MEMORY 



The 5250 Adapter usually 
resides between: 



UPPER MEMORY AREA 
Rom Bios 
**5256 Adapter** 
3270 Adapter 
VGA/EGA 



CONVENTIONAL 
MEMORY 



TSR, DEVICE DRIVERS 



-1024K(FFFFh) CCOGh - DF60h 



CCOOh 



-640K(A000h) 



-OK 



In this sample map, 
other devices use 
the Upper Memory 
area. 

The configuration 
program executed after 
the installation will 
let you choose which 
memory block the 
5250 Adapter uses. 



Press [Esc] to quit, any other key to continue 



Figure 3-7. Sample Memory Map Screen 



The 5250 adapter requires an 8KB section of memory space. 
This memory space is typically from x'CCOO 1 to x'CDFF 1 or 
x 1 DCOO 1 to x 1 DDFF 1 . Depending on your personal computer, 
the adapter might be able to fit into other memory locations, such 
as x 1 ECOO 1 to x' EDFF 1 . For memory locations that you can 
use for the IBM 5250 Emulation Family adapters, see 
Figure 3-16 on page 3-23. 

For the 5250 Emulation PCMCIA Adapter: You might need to 
reserve more than 8KB of space because of Card and 
Socket Services requirements. For more information 
about memory requirements for the 5250 Emulation 
PCMCIA Adapter, see the Installation and Test 
Instructions manual that was provided with your adapter. 

After you read the Sample Memory Map screen, press any key 
to continue. 
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10. The System Considerations screen appears. Please read this 
information carefully. 

If you are using a memory manager program, like EMM386, it is 
highly recommended that you add a memory exclusion 
parameter to the end of the EMM386 line in the CONFIG.SYS 
file. If you configure your adapter for the x 1 CC00 1 to x 1 CDFF 1 
range, your EMM386 line might look like this: 

DEVICE=C:\D0S\EMM386 X=CC00-CDFF 

After you read the System Considerations screen, press any key 
to continue. 

1 1 . The installation program pauses before installing the program 
files. Press any key to start installing the program files. 

When installation program ends, the adapter selection program 
(HWCONFIG) automatically starts. 

12. Configure the Emulation Program for your adapter using the 
instructions in "Selecting the Adapter." 



Selecting the Adapter 

For all the IBM 5250 Emulation Family adapters, you must run the 
adapter selection program (HWCONFIG) to identify to the Emulation 
Program the adapter that you are using. 

Using the Adapter Selection Program 

The adapter selection program begins automatically when the 
installation program ends. You can also start the adapter selection 
program without running the installation program. 

Warning: Do not run the adapter selection program while the 
Emulation Program is using your adapter. 
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To start the adapter selection program without running the installation 
program: 

1. Change to the emulation directory. For example, if you installed 
the Emulation Program in the default directory (EM5250) on the 
C: drive, you would type CD C:\EM5250 and press Enter to 
continue. 

2. Type HWCONFIG and press Enter to continue. 

The HWCONFIG program starts, and the Notice screen, shown in 
Figure 3-8, appears. 



Adapter Selection 
for the Enhanced 525G Emulation Program 

— Notice — 

Do not run this selection program if 5258 emulation software is currently 
using your adapter. If 525G emulation software is not currently using the 
adapter, this configuration program may safely continue. 

The 5256 emulation adapter installed in your system must be specified and 
saved before you can use the Enhanced 5256 Emulation Program. 



Copyright (c) IBM Corporation 1994 
F3=Exit Enter=Continue 



Figure 3-8. Adapter Selection Notice Screen 
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Do one: 

• If you are running the Emulation Program: 

1. End the Emulation Program. 

2. Restart the HWCONFIG program. 

• To continue the HWCONFIG program, press Enter to continue. 
The Adapter Selection screen, shown in Figure 3-9, appears. 





Adapter Selection 
for the Enhanced 5258 Emulation Program 


-1- 


IBM Enhanced 5258 Emulation Adapter 
for IBM PC, ISA, and EISA systems 


-2- 


IBM 5258 Emulation Adapter/A 
for IBM Micro Channel systems 


-3- 


IBM 5258 Emulation PCMCIA Adapter 


Use the up and down arrow keys to select the 5250 emulation adapter 
installed in your system. To save your adapter selection, Press F3 and then 
select Option 1 on the exit screen. For configuration information about 
your adapter press F6. 


U=Select 


Fl=Help F3=Exit F6=Adapter Configuration 



Figure 3-9. Adapter Selection Screen 
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To identify the adapter that you are using to the Emulation Program: 

1. From the Adapter Selection screen, shown in Figure 3-9 on 
page 3-13, use the arrow keys to select the adapter. 

2. Press F3 to exit the HWCONFIG program. The Exit Options 
screen, shown in Figure 3-10, appears. 



Adapter Selection 
for the Enhanced 5250 Emulation Program 



IBM Enhanced 5250 Emulation Adapter 
for IBM PC, ISA, and EISA systems 

IBM 5250 Emulation Adapter/A 
for IBM 



-3- IBM 5250 

Use the up and dow 
installed in your 
select Option 1 on 
your adapter press 



U=Select Fl=Help 



Exit Options 

-1- Save selections then exit. 

-2- Exit without saving selections. 

Select your exit option and then press Enter. 
H=Select Enter Esc=Previous Screen 



Figure 3-10. Exit Options Screen 
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3. Use the arrow keys to select Save selections then exit (1) and 
press Enter. 

Note: If you do not want to save the changes you made, select 
Exit without saving selections (2) and press Enter. 

Note: If you receive an error message when you start the Emulation 
Program, see "Adapter Conflicts" on page 3-22 for information about 
resolving conflicts between the adapter and memory or other 
adapters that are installed in your personal computer. 



Configuring the Adapter 

In addition to configuring the Emulation Program for the adapter that 
you are using and for the 5250 session information, you might need 
to specify or change your adapter configuration. 



How you configure your adapter depends on which adapter you are 
using. The programs for configuring the IBM 5250 Emulation Family 
adapters are described in Figure 3-11. 



Figure 3-11 (Page 1 of 2). Adapter Configuration Programs 


Enhanced 5250 Display Station Emulation Adapter 
(for PC/AT, ISA, and EISA bus personal computers) 


Program: 


HWCONFIG 


Source: 


Installed on your personal computer by the INSTALL 
program for the IBM Enhanced 5250 Emulation Program. 


Description: 


The HWCONFIG program can be used to specify the 
interrupt level, memory mapped segment, and I/O port 
address used by the IBM Enhanced 5250 Emulation 
Program. 
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Figure 3-11 (Page 2 of 2). Adapter Configuration Programs 


5250 Emulation Adapter/A (for Micro Channel bus personal 
computers) 


Program: 


Set Configuration Option on the reference diskette 


Source: 


The configuration files for the 5250 Emulation Adapter/A 
are on the Option Diskette that was provided with your 
adapter. 


Description: 


To change the interrupt level, the memory mapped 
segment, and the I/O port address used by the emulation 
adapter, follow the instructions that were provided with 
your adapter in the Installation and Test Instructions 
manual. 


5250 Emulation PCMCIA Adapter (for PCMCIA bus personal 
computers) 


Program: 


CFG5250 


Source: 


This program is installed on your system by the SETUP 
program on the Enabler/Diagnostic Diskette that was 
provided with your adapter. 


Description: 


This program is used to specify or change the 
configuration of your PCMCIA adapter. For more 
information, see the Installation and Test Instructions 
manual that was provided with your adapter or 
Appendix C, "PCMCIA Setup Considerations." 



Configuring the Enhanced 5250 Display Station 
Emulation Adapter 

The adapter uses the following default settings: 

Interrupt level 5 

I/O port address 271 8-271 F 

Memory segment CC00-CDFF, DC00-DDFF, or EC00-EDFF 

Only change the default adapter selection settings when other 
hardware that is installed on your personal computer conflicts with 
the emulation adapter. Use the adapter selection program 
(HWCONFIG) to change the default I/O address, interrupt level, and 
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card address for the Enhanced 5250 Display Station Emulation 
Adapter. 

If you change the default adapter selection settings, you must 
change the switches on the adapter to match the new configuration 
settings. For information about setting the I/O address switches, see 
the Guide to Operations or Installation and Test Instructions manual 
that was provided with your adapter. 

Warning: Do not run the HWCONFIG program while the Emulation 
Program is using your adapter. For information about starting the 
HWCONFIG program, see "Using the Adapter Selection Program" on 
page 3-11. 

To examine or change the settings for the adapter: 

1. If you are running the Emulation Program: 

a. End the Emulation Program. 

b. Restart the HWCONFIG program. 

2. Start the HWCONFIG program by doing the following: 

a. Change to the emulation directory. For example, if you 
installed the Emulation Program in the default directory 
(EM5250) on the C: drive, you would type CD C:\EM5250 
and press Enter to continue. 

b. Type HWCONFIG and press Enter to continue. The Notices 
screen appears. 
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3. To continue the HWCONFIG program, press Enter. The Adapter 
Selection screen, shown in Figure 3-12, appears. 



Adapter Selection 
for the Enhanced 5259 Emulation Program 



-1- IBM Enhanced 5256 Emulation Adapter 
for IBM PC, ISA, and EISA systems 

-2- IBM 5259 Emulation Adapter/A 
for IBM Micro Channel systems 

-3- IBM 5259 Emulation PCMCIA Adapter 

Use the up and down arrow keys to select the 5259 emulation adapter 
installed in your system. To save your adapter selection, Press F3 and then 
select Option 1 on the exit screen. For configuration information about 
your adapter press F6. 



U=Select Fl=Help F3=Exit F6=Adapter Configuration 



Figure 3-12. Adapter Selection Screen 
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4. Use the arrow keys to select the IBM Enhanced 5250 Emulation 
option and press F6 to continue. The Enhanced 5250 Emulation 
Adapter Configuration screen, shown in Figure 3-13, appears. 







Adapter Selection 
for the Enhanced 5258 Emulation Program 






Enhanced 5258 Adapter Configuration 




Interrupt 
I/O Port 
Memory 


5 

2718-271F 
Automatic 


Us 
in 

se 

yo 


Select which parameter to change and then press F6. 


n 


ti=Select 


Fl=Help F3=Exit F6=Change Esc=Previous Screen 



Figure 3-13. Enhanced 5250 Adapter Configuration Screen 

5. Use the arrow keys to select the option you want to change and 
then press F6 to continue. 
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6. Follow the instructions that appear on the screen. After you 
make your selection, press Enter to continue. 

For example, if you wanted to change the interrupt level from 5 
to 4, you would select 4 and then press Enter to continue, as 
shown in Figure 3-14. 



Adapter Selection 
for the Enhanced 5250 Emulation Program 



Enhanced 5250 Adapter Configuration 



Interru 



Interrupt 



I/O Por 



Select your interrupt choice and then press Enter. The 
default interrupt choice is 5. 



Memory 



Us 
in 
se 
yo 



Select wh 



3 
4 
5 
6 
7 



H=Select 



U-Select Enter Esc=Cancel 



Figure 3-14. Adapter Configuration Screen 
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7. When you are finished changing the configuration for your 
emulation adapter, press F3 to exit the HWCONFIG program. 
The Exit Options screen, shown in Figure 3-15, appears. 





Adapter Selection 
for the Enhanced 5259 Emulation Program 






Enhanced 5250 Adapter Configuration 




Interrupt 
I/O Port 


5 

2718-271F 




Memory 


Exit Options 


Us 
in 
se 

yo 


Select which p 


-1- Save selections then exit. 

-2- Exit without saving selections. 

Select your exit option and then press Enter. 


U 


U=Select Fl= 


U=Select Enter Esc=Previous Screen 



Figure 3-15. Exit Options Screen 

8. Use the arrow keys to select Save selections then exit (1) and 
press Enter to continue. 

Notes: 

a. If you do not want to save the changes you made, select Exit 
without saving selections (2). 

b. If you receive an error message when you start the 
Emulation Program, use the HWCONFIG program to resolve 
any conflicts between the adapter and memory or other 
adapters that are installed in your personal computer. For 
information about resolving memory conflicts, see "Memory 
Usage" on page 3-23. 

For more information about configuring your adapter, see the Guide 
to Operations or the Installation and Test Instructions manual that 
was provided with your adapter. 
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Configuring the 5250 Emulation Adapter/A 

Only change the default adapter selection settings when other 
hardware that is installed on your personal computer conflicts with 
the emulation adapter. To configure the 5250 Emulation Adapter/A, 
use the Set Configuration Option on the reference diskette for your 
personal computer and the adapter configuration files on the Option 
Diskette that was provided with your adapter. 

To change the I/O address, interrupt level, and card address that the 
adapter uses, follow the instructions in the Installation and Test 
Instructions manual that was provided with your adapter. 

For information about resolving memory conflicts, see "Memory 
Usage" on page 3-23. 

Configuring the 5250 Emulation PCMCIA Adapter 

Only change the default adapter selection settings when other 
hardware that is installed on your personal computer conflicts with 
the emulation adapter. To configure the 5250 Emulation PCMCIA 
Adapter, use the CFG5250 program (that was installed from the 
Enabler/Diagnostic Diskette when you installed and configured the 
adapter). 

Memory allocation can be complex for PCMCIA computers. For 
information about configuring the 5250 Emulation PCMCIA Adapter, 
see Appendix C, "PCMCIA Setup Considerations," or the 
Installation and Test Instructions manual that was provided with your 
adapter. 

For information about resolving memory conflicts, see "Memory 
Usage" on page 3-23. 



Adapter Conflicts 

Usually when there is an adapter conflict, an error message appears 
when you start the Emulation Program (DP5250). To resolve an 
adapter conflict, use the adapter configuration procedure for your 
adapter to change the I/O port addresses, the memory mapped 
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segment space, or the interrupt level that your emulation adapter 
uses. 

For more adapter configuration information, see "Configuring the 
Enhanced 5250 Display Station Emulation Adapter" on page 3-16, 
"Configuring the 5250 Emulation Adapter/A" on page 3-22, or 
"Configuring the 5250 Emulation PCMCIA Adapter" on page 3-22. 



Memory Usage 

The most common type of adapter conflict involves memory usage. 
The memory allocation map for each personal computer is unique. 
You must find the segment on your computer that allows the adapter 
to coexist with your personal computer. 



Figure 3-16. Memory Segments 


Enhanced 5250 Display 
Station Emulation Adapter 


5250 Emulation 
Adapter/A 


5250 Emulation 

PCMCIA 

Adapter 


CCOO-CDFF 
DCOO-DDFF 
ECOO-EDFF (See note.) 
ACOO-ADFF (See note.) 
BCOO-BDFF (See note.) 


C000-C1FF 
C400-C5FF 
C800-C9FF 

DCOO-DDFF 


C000-C1FF 
C400-C5FF 
C800-C9FF 

DCOO-DDFF 


Note: Segments ECOO-EDFF, ACOO-ADFF, and BCOO-BDFF are 
usually not recommended, but they can be used on some personal 
computers. 



Figure 3-16 shows the memory segments that your 5250 emulation 
adapter can use. If one of the memory segments for your system is 
available, use that segment. To change the memory segment, 
reconfigure the adapter. 

For information about the adapter configuration programs, see 
"Configuring the Adapter" on page 3-15. For more information about 
configuring your adapter, see "Configuring the Enhanced 5250 
Display Station Emulation Adapter" on page 3-16, "Configuring the 
5250 Emulation Adapter/A" on page 3-22, or "Configuring the 5250 
Emulation PCMCIA Adapter" on page 3-22. 
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If your personal computer uses an expanded memory manager (for 
example, EMM386, QEMM, or 386MAX), you must exclude the 
segment that you assign to the emulation adapter from the expanded 
memory manager. Use your expanded memory manager to exclude 
the segment. 

For example, if you were using EMM386, you would add a statement 
similar to the one below to your CONFIG.SYS file: 

DEVICES r\WIND0WS\EMM386.EXE x=CC00-CDFF 

Memory allocation can be affected by: 

• LOADHIGH device statements 

• Number of files and buffers 

• FCBs 

• DEVICEHIGH device statements 

• DOS=HIGH options 

• Optional parameters on the expanded memory manager 
statements (for example, for EMM386, RAM, AUTO, EMS, 
NOEMS, FRAMES, and so forth) 

When correcting a memory conflict, you might need to adjust some 
of these parameters. 
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Configuring for Emulation 

You must run the session configuration program (CONFIG.EXE) 
before using the Emulation Program the first time. You can run the 
CONFIG.EXE program before the adapter is installed and before the 
personal computer is connected to the host. 

Note: When you ran the INSTALL program, the CONFIG.EXE 
program was copied onto your personal computer. The 
SCR5250.TXT and HLP5250.TXT files must be in the same directory 
as the CONFIG.EXE program. 

The CONFIG.EXE program generates a session profile 
(DP5250.DAT) or changes an existing session profile. The session 
profile identifies key attributes of the emulated 5250 Display Station 
that allow the Emulation Program to use the adapter and to 
communicate with the host. If a Version 2.4 session profile (a file 
with a .DAT extension) is not in the current directory, the Emulation 
Program will not start. For information about converting a session 
profile from an earlier version of the Emulation Program, see 
"Converting 2.12 or Later Profiles to 2.4 Level" on page 3-38. 

When you run the CONFIG.EXE program, it shows the available 
options and prompts you for responses that are required for a 
complete and usable configuration. You can use this program to 
create a new profile (for example, to change printers or the number 
of sessions) or to change an existing profile. After the basic 
configuration is completed, you can quit, save the profile, or continue 
with the advanced options. 

Using the advanced options requires some technical knowledge. For 
information about these advanced options, see Chapter 1 1 , 
"Advanced Configuration." 

Note: To view the correct display parameters for the IBM Portable 
Personal Computer, you must use the Advanced Options Menu. 

For information about using the Emulation Program under OS/2, see 
"Using the Emulation Program with OS/2" on page 3-36. 
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Configuration Checklist 

Use the following checklist to plan or to record configuration 
information. This checklist is not intended to replace the help text in 
the configuration program. 

Number of Sessions (1 or 2): 

Language Used: 

Name of Keyboard Customization File: 

Type of PC Printer (optional): 

Host Assigned Workstation Addresses: 

Primary display address 

Secondary workstation address 

Session Type for Second Session (optional): 

5224/25 Printer 

5256 Printer 

5219 Printer 

Display 

Name of Session Profile (optional): 

DP5250.DAT 

myfile.DAT 

Running the Session Configuration Program 

To use the session configuration program, follow the instructions in 
this section and type the responses for each screen. For additional 
information about the responses you need to make, use the help text 
for the configuration program. 
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Make sure you are in the emulation directory before following these 
steps. 

1. At the DOS prompt, type: CONFIG 

If you are changing a session profile, type: 
CONFIG myfile.DkT 

where myfile is DP5250.DAT or your session profile. The 
configuration logo screen, shown in Figure 3-17 appears. Press 
Enter to continue. 




Session Configuration 
Enhanced 5256 Emulation Program 
Version 2.46 

(C) Copyright IBM Corp. 1985, 1994. All rights reserved. 



Press (Enter) to continue 



Figure 3-17. Configuration Logo Screen 
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2. From the Set Number of Sessions screen, shown in Figure 3-18, 
select the number of sessions. 



Session Configuration for Enhanced 5258 Emulation 



Set Number of Sessions 






.... [2] 


(1 or 2) 




Press <— 1 (Enter) when complete 





Fl-»-HELP F2-»-Prev Screen 



Figure 3-18. Set Number of Sessions Screen 
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3. From the Language Selection Menu, shown in Figure 3-19, 
select your language. This selection is important because it 
determines which keyboard customization file to use and other 
language-specific information that is reported to the host. 
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Language Selection Menu 


* 01. US 

62. Belgian 

63. Brazilian 

64. Canadian French 

65. Danish 

66. Dutch 

67. French 

68. German 

69. Greek 
10. Icelandic 




11. Italian 

12. Latin American 

13. Norwegian 

14. Portuguese 

15. Spanish 

16. Swedish/Finnish 

17. Swiss-French 

18. Swiss-German 

19. Turkish 

20. UK 


Enter Selection . 




. . .[61] 


Press (Enter) when complete 
* indicates current value 




F1-*HELP 




F2-»-Prev Screen 



Figure 3-19. Language Selection Menu 
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4. From the Keyboard Selection Menu, shown in Figure 3-20, 
select the type of keyboard attached to your personal computer. 
The combination of language and keyboard selections 
determines which keyboard customization file to activate. For a 
list of the keyboard customization files, see Figure E-2 on 
page E-4. 

If you have modified a keyboard customization file, select 
option 04 and enter the file name of your modified keyboard 
customization file. The currently active keyboard customization 
file is displayed. 
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Keyboard Selection Menu 






* 81. Enhanced Style Keyboard 
62. AT Style Keyboard 

03. PC-XT Style Keyboard 

04. Select user created profile 

[ ] 






Active keyboard profile: 
US E.PRO 












Press (Enter) when complete 
* indicates current value 




Fl-^HELP F2-»-Prev Screen 



Figure 3-20. Keyboard Selection Menu 



3-30 Enhanced 5250 User's Guide 



5. From the screen shown in Figure 3-21, select the Host to PC 
display code page mapping. Because the Host uses an EBCDIC 
code page and the personal computer uses an ASCII code page, 
a table must be used to map the EBCDIC characters to ASCII 
characters. 

A code page is a set of displayable characters that is assigned 
to the 256 code points in the code page. The default mapping 
for the configuration program is EBCDIC code page 037 to 
personal computer code page 437. You must use the same 
code page as configured in your DOS session. 

Select the mapping that matches your host and personal 
computer code pages and press Enter to continue. If you use 
PC Support/36 or PC Support/38, you must use personal 
computer code page 437. 
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Select Host to PC Display Code Page Mapping 





Host 




Personal 




Host 




Personal 




Code 




Computer 
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Computer 




Page 




Code Page 




Page 




Code Page 


61. 


037 




437 


69. 


297 




856 


62. 
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850 


16. 
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437 


63. 


273 




850 


11. 


500 




819 


64. 


277 




850 


12. 


500 




856 


65. 


278 




850 


13. 


871 




819 


66. 


286 




850 


14. 


871 




850 


67. 


284 




850 


15. 


875 




869 


68. 


285 




850 


16. 


1026 




857 



Enter option for Code Page. . . . [01] 

Press (Enter) when complete 
* indicates current value 



F2-*-Prev Screen 



Figure 3-21. Select Host to PC Display Code Page Mapping Screen 
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6. From the Primary Workstation Address screen, shown in 

Figure 3-22, specify the workstation addresses assigned to your 
workstation. 
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Primary Workstation Address 












Session 2 [1] 






Enter a value from 6 to 6. 






Press -»- J (Enter) when complete 




Fl-*-HELP F2-»-Prev Screen 



Figure 3-22. Primary Workstation Address Screen 
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7. If you specified 2 sessions, select a printer or display for 
session 2 from the Select Session 2 Type screen, shown in 
Figure 3-23. 
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Select Session 2 Type 






Session 1 is a display session. 






* 1. 5256 printer emulation 

2. 5219 printer emulation 

3. 5224/5225 printer emulation 

4. Display emulation 










• .[1] 






Press (Enter) when complete 
* indicates current value 






Fl-^HELP 


F2-»-Prev Screen 



Figure 3-23. Select Session 2 Type Screen 
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8. If you specified session 2 as a printer, select the type of printer 
attached to your personal computer from the Attached Printer 
List screen, shown in Figure 3-24. If your printer is not listed, 
enter a Printer Function Table (PFT) file name for your printer. 
Press F1 to see a list of PFT file names. 

For information on the Printer Function Setup program, see 
Chapter 10, "Using the Printer Function Table Setup Program." 
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Attached Printer List 




* 1. IBM PC Graphics Printer 

2. IBM PC Matrix Printer 

3. IBM Proprinter 

4. IBM Wheel printer Printer (Model 5216) 

5. IBM Color Printer (Model 5182) 

6. IBM Quietwriter Printer (Model 5201) 

7. Table driven (user-defined) printer 

[ 


] 






Press ■*— 1 (Enter) when complete 
* indicates current value 





Fl-»-HELP F2-»-Prev Screen 



Figure 3-24. Attached Printer List Screen 
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9. If you specified session 2 as a printer, select the host to printer 
code page mapping from the screen shown in Figure 3-25. 
Because the host uses an EBCDIC code page and personal 
computer-attached printers use ASCII code pages, a table must 
be used to map the EBCDIC characters to ASCII characters. 
Select the mapping that matches your host and printer code 
page values and press Enter to continue. 



Session Configuration for Enhanced 5250 Emulation 
Select Host to Printer Code Page Mapping 





Host 




Printer 




Host 




Printer 




Code 




Code 




Code 




Code 




Page 




Page 




Page 




Page 


61. 


037 


*■ 


437 


69. 


297 




850 


02. 


037 


-> 


850 


10. 


566 




437 


63. 


273 




856 


11. 


566 




819 


04. 


277 




856 


12. 


566 




850 


05. 


278 




856 


13. 


871 




819 


06. 


280 




850 


14. 


871 


-> 


850 


07. 


284 




856 


15. 


875 




869 


08. 


285 


-►- 


856 


16. 


1026 




857 



Enter option for Code Page. . . . [01] 

Press ■«- J (Enter) when complete 
* indicates current value 



Fl-^HELP F2-»-Prev Screen 



Figure 3-25. Select Host to Printer Code Page Mapping Screen 

10. Save your updates by selecting option 1 at the Advanced Display 
Emulation Options screen. Write down the file name that you 
used (for example, DP5250.DAT). 
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1 1 . If you want to work with the advanced options, do one: 

• For additional display options, select option 3, Select Display 
Emulation Options. 

• For additional printer options, select option 4, Select Printer 
Emulation Options. 

For more information about the advanced options, see 
Chapter 11, "Advanced Configuration." 

12. To exit the Emulation Program, select option 2. 

You are now ready to start the Emulation Program. Go to 
Chapter 4, "Operating the Emulation Program." 



Using the Emulation Program with OS/2 

You can use the Emulation Program in an OS/2 Version 2.1 DOS 
session. Interrupt sharing is not supported when using the Emulation 
Program under OS/2. 

Installing under OS/2 

To install the Emulation Program under OS/2, you must run the 
INSTALL program from a full-screen DOS session. 

Note: You must run the CONFIG program from a full screen DOS 
session. 
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To set up under OS/2 Version 2.1: 

1 . From the Command Prompts folder, choose either DOS Full 
Screen or DOS Window, depending on how you want to run the 
Emulation Program. 

2. Using the right mouse button, click on the icon. 

3. Using the left mouse button, click on OPEN. 

4. Choose Settings. 

5. Select the Session tab and choose DOS Settings. 

6. Select KBD_CTRL_BYPASS. Select Alt+Esc. 

7. Select the Window tab. Set the radio button for Create New 
Window. 

8. Choose Save and close the window. 

Running under OS/2 

Warning: Do not use the DOS session while running the Emulation 
Program with OS/2. Entering any DOS command except EXIT (to 
end the Emulation Program) can cause unpredictable results. 

To run under OS/2 Version 2.1: 

1 . Start a DOS session using the DOS icon that you set up for use 
with the Emulation Program. 

2. Change to the directory where the Emulation Program was 
installed. 

3. Type DP5250 and press Enter to continue. 
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Ending the Emulation Program under OS/2 

To end the Emulation Program, do one: 

• Hot key to the DOS prompt in your 5250 emulation DOS session 
and type EXIT 

• From the Task list, click on the DOS session with the right 
mouse button and select Close. 



Converting 2.12 or Later Profiles to 2.4 Level 

If you have session profiles from Version 2.12 or later of the 
Emulation Program, you can update them for use with Version 2.4. 
To update the session profiles, run CONFIG.EXE using your existing 
session profile as input. For example, if your Version 2.3 session 
profile is named MYPROF.DAT, you would type the following 
command at the DOS prompt and press Enter: CONFIG MYPROF.DAT 

When the profile is saved, it is updated to the format required for 
Version 2.4 of the Emulation Program: 

• The name of the keyboard customization file that is in the 
session profile is changed to the name of the closest valid 
keyboard customization file for Version 2.4. Figure 3-26 shows 
the old and new keyboard customization file names, where 
xxxxxx in the new file name indicates which supported language 
the keyboard uses. For a list of the keyboard customization files 
that are supplied with the Emulation Program, see Figure E-2 on 
page E-4. 



Figure 3-26. Changes to the Keyboard 
Customization File Names 


Old File Name 


New File Name 


KB5250 


xxxxxx-P.PRO 


KBA5250 


xxxxxx-A.PRO 


KBPC 


xxxxxx-P.PRO 


KBAPC 


xxxxxx-A.PRO 


KBEPC 


xxxxxx-E.PRO 


CUSTOM 


xxxxxx-E.PRO 
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• If a 5292 session is defined in the session profile, it is changed 
to a 3197 session. You might have to ask the host system 
operator to change the workstation address or the host device 
description. 

All other values in the session profile remain unchanged. 

Keyboard customization files from Version 2.12 or later are not 
compatible with Version 2.4. If you made changes to a keyboard 
profile, you must edit the new keyboard customization file and make 
the changes again. For instructions on defining a keyboard, see 
"Changing the Keyboard Customization File" on page 6-8. 

Printer Description Table (PDT) data sets are not compatible with 
Version 2.4. Run the PFTSETUP program to create profiles for any 
user-defined printers. For information about printer function tables, 
see Chapter 10, "Using the Printer Function Table Setup Program." 
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Chapter 4. Operating the Emulation Program 



You cannot run the Emulation Program if your adapter is not 
installed. For installation directions, see the Guide to Operations or 
Installation and Test Instructions manual for your adapter. 

Make sure all devices attached to the personal computer are turned 
on before loading the Emulation Program. 

There are two Emulation Programs, DP5250.COM and PRT5250. 
DP5250.COM provides the display session capabilities and the 
functionality for emulation. PRT5250 provides the printer session 
capabilities and is loaded by DP5250.COM only if a printer session is 
configured. Only DP5250.COM needs to be run. 



Loading the Programs 

Before you can begin, you must create an emulation session profile 
by using the CONFIG.EXE program that is provided on the 
Emulation Program diskette. 

The process of loading programs on a personal computer is not 
limited to one method. The sequence in which the programs are 
loaded is critical. 

The Emulation Program may be loaded either step by step (see 
"Loading Options from the DOS Prompt") or may be loaded 
automatically (see "Automatically Loading Programs" on page 4-3). 

Loading Options from the DOS Prompt 

When loading a program from the DOS prompt, values can be 
provided (as parameters) with the command that invokes the 
program. These values may specify a session profile and a 
keyboard customization file. The parameters must follow the 
program name with one space between the program name and the 
first parameter. 
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To start emulation with the default session profile (DP5250.DAT), 
type DP5250 from within the directory containing the Emulation 
Program and press Enter. 

To specify a different session profile, type: 

DP5250 I=myf/7e.DAT 

This loads profile tables from a file named myfile.DAT located in the 
current directory. If a session profile is not specified, DP5250.DAT is 
loaded as the profile. See "Configuring for Emulation" on page 3-25 
for more information about session profiles. 

Note: You must have a session profile or the Emulation Program 
will not run. 

If an error occurs during the reading or opening of a session profile, 
a File Not Found error message is displayed. For information about 
this message, see File Not Found on page A-3. 

If a problem occurs after opening the profile, the Unusable 
Initialization Data error message is displayed. For information about 
this message, see Unusable Initialization Data on page A-3. 

To specify a keyboard customization file, specify the keyboard 
customization file when you start the Emulation Program. For 
example, to use the US enhanced keyboard customization file, type: 

DP5250 K=US E.PRO 

The keyboard customization file name is normally provided by the 
session profile. By specifying a different file name on the command 
line, you can use a different keyboard customization file than the one 
contained in the session profile. 

You can specify both a session profile and a keyboard customization 
file on the same command line. For example: 

DP5250 I=myf/7e.DAT K=US E.PRO 
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To specify a printer function table (PFT) different from the one 
specified in your session profile, type: 

DP5250 P= printable. PFT 

The PFT file describes the characteristics of an otherwise 
unsupported printer to the Emulation Program. If you did not specify 
a table-driven (user-defined) printer during configuration, the 
Emulation Program ignores any PFT file that you specify when 
starting the session profile. 

If you do not specify a file name for the PFT file, the file name in the 
session profile is used. 

Note: The Emulation Program is designed to have only one copy of 
the program in memory at a time. An error message is displayed if 
you attempt to load a second copy. (The first copy of the program is 
still functional.) 

Automatically Loading Programs 

If you use an AUTOEXEC.BAT file to load your Emulation Program, 
it is assumed that DOS, COMMAND.COM, and the Emulation 
Program are loaded in the same directory or that a path was 
established for DOS to find the files. (See "Loading the Programs" 
on page 4-1 if you are not using an AUTOEXEC.BAT file.) 

Adding DP5250 to your AUTOEXEC.BAT file automatically loads the 
Emulation Program. Program parameters can be added to the 
command line as part of the AUTOEXEC.BAT file. "Loading Options 
from the DOS Prompt" on page 4-1 gives examples of how to use 
parameters. 

Program parameters can appear in any combination. Spaces are 
required between parameters, but are not allowed between 
characters within parameters. When two conflicting parameters are 
typed, the last parameter in a left-to-right scan is used. Invalid 
program parameters are identified in an error message. 

If another parameter follows a program name, then blanks are 
required. For example, a blank (or space) must be used between 
DP5250 and 1= my file. DM, like this: DP525G I = my file. DAT 
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DOS commands can be specified on separate lines in an 
AUTOEXEC.BAT file, as shown in the following example: 

SET ENB5250=[D:] [path] (For PCMCIA systems only. See Note 2.) 
CD\EM5250 

DP5250 I=myf/7e.DAT 

pc application program name 

This sequence sets the ENB5250 environment variable, loads the 
Emulation Program, and brings the host online without further 
operator involvement. The application program is then automatically 
loaded. 

Notes: 

1. This AUTOEXEC.BAT file assumes that the automatic hot key 
option was selected during session configuration (CONFIG.EXE). 

2. For PCMCIA personal computers only, you must set the 
environment variable, ENB5250=[D:] [PATH], so that the 
PCMCIA card configuration files can be found. It is 
recommended that you add this command in the 
AUTOEXEC.BAT file. 
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Starting the Emulation Program 

If you have not specified bypass of the pre-signon screen, a screen 
similar to that shown in Figure 4-1 should appear after: 

• DOS is loaded. 

• DP5250.DAT is loaded. 

• The emulation adapter is found. 

• The emulation adapter passes a memory test. 

• The station addresses are tested for availability. 

If you have not specified bypass of the pre-signon screen and it does 
not appear, refer to Appendix B, Problem Determination. 



Enhanced 5250 Emulation Program 
EC02.40 mm/dd/yy 
Copyright IBM 1985, 1994 
K=US E.PRO 

1) 3196 Display at station address = y 

2) 5256 Printer at station address = z 

Press any key to continue 



Figure 4-1. Pre-Signon Screen 

Although the pre-signon screen is displayed, your personal computer 
is not yet online with the host. The pre-signon screen identifies the 
program and the engineering change level, and it displays the 
copyright notice. 

The numbers at the start of the fifth and sixth lines of the pre-signon 
screen are the session numbers, and y and z at the end of the fifth 
and sixth lines are the workstation addresses for those sessions. 
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Line four is the keyboard customization file that was chosen during 
configuration. 

When you press a key, DP5250 (the Emulation Program) attempts to 
communicate with the host using the addresses in the session 
profile. The workstation addresses being attempted are displayed in 
a message while the activity is in progress. After the personal 
computer comes online with the host, an alarm sounds and the 
pre-signon screen is replaced with a host screen. The keyboard is 
now in emulation mode and is defined by the keyboard customization 
file. The status is on line 25 of the display screen. Refer to 
"Understanding the Status Indicators" on page 5-3 for an explanation 
of the status line indicators. 

If the adapter is operational, the host signon screen appears. 
Otherwise, an error message appears on the pre-signon screen. 
Refer to Appendix A, Error Codes and Messages, for further 
information. 

At this point, the keyboard only responds as defined by the keyboard 
customization file that was selected during session configuration. 
The examples in this chapter assume that the keyboard used is an 
enhanced-style keyboard. 

Notes: 

1. If the address is already being used by another workstation, the 
message Station Address Already In Use is displayed. 

2. If a workstation that is not capable of searching for an address is 
turned on and its address is already in use, the device that is 
using this address has its session interrupted and the workstation 
starting up is unable to establish its session (address contention). 

3. If the Emulation Program is loaded on two or more personal 
computers using the same workstation address within an 
8-second period, the host (or controller) may stop talking to both 
devices. If this occurs, reload the Emulation Program on the first 
personal computer, wait at least 8 seconds, then load the 
Emulation Program on the second personal computer using a 
different workstation address. 
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If an error is detected by the host during online operation, it is 
displayed as a 4-digit error code on the left end of line 25. Refer to 
"Four-Digit Terminal Error Codes" on page A-13 for descriptions of 
the error codes. Errors not defined in Appendix A may be found in 
Appendix B, Problem Determination. 

When you have successfully loaded DP5250, your personal 
computer emulates a display and, if two sessions were chosen 
during configuration, either a second display or printer. 

To support S/36 computers and controllers using the 
auto-configuration feature, the Emulation Program must be loaded 
and brought online before the host or controller is turned on. You 
must ensure that every personal computer on the workstation line 
has a unique workstation address for every emulation session. 
Then, when the System Not Available for Station Ax message is 
displayed, select the Ignore option. 

The AS/400 auto-configuration feature allows you to start emulation 
anytime the AS/400 computer is running. Sessions are automatically 
configured at the host. 

For information about how each key and key sequence on the 
emulated keyboard works, refer to Chapter 6, Using the Keyboard. 

To use the functions of the host, you must sign on to the host. 
Check with the person with the appropriate host system authority for 
your signon requirements (password). 

If contact is established with the host, the System Available indicator 
comes on and either the cursor is displayed in the upper left corner 
of the display screen or a signon screen appears. 

If contact is not made with the host, the System Available indicator is 
off and the cursor is displayed in the upper right corner of the display 
screen. 
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Printing the Screen during Emulation Mode 



Printing on a Host System Printer 

When the Shift+Print Screen keys are pressed, a print request is 
sent to the host and your screen is printed or spooled by the host. 

Printing on a Personal Computer Printer 

When the Print Screen key is pressed, your host screen is printed on 
your personal computer printer. EBCDIC codes below hex 20 are 
not translated. The codes below hex 20 are sent to the printer as is. 
Codes above 20 are translated using information provided in the 
Technical Reference manual. See the instructions for your printer to 
determine the action taken. 

Note: If printer emulation is running and is using the same physical 
printer as the personal computer, you must suspend the printer 
session from the emulated printer operator panel before the personal 
computer print screen function works. (See "5219 Printer Emulation 
Display" on page 7-5, for 5219 emulation; "5256 Printer Emulation 
Display" on page 9-4, for 5256 emulation; or "5224 Printer Emulation 
Display" on page 8-5, for 5224 emulation.) 



Leaving Emulation Mode 

You can leave an emulation session by using the software reset 
sequence (DOS systems only) or by using the hot key sequence 
(default is Alt+Esc). 

Using the Software Reset Sequence 

Warning: 

• Do not use the software reset to end an OS/2 session. 

• If you are running an application on the personal computer, do 
not use the software reset sequence (Ctrl, Alt, and Del keys 
simultaneously) to leave an emulation session until you have 
ended your DOS application. An error occurs causing the 
personal computer to stop running. When this occurs, you must 
reload DOS and any other programs you want to have running. 
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The software reset sequence takes the display station offline from 
the host and returns the personal computer to the DOS prompt. To 
the host, this is the same as turning off a 5250 display. 

To end emulation on a DOS-only personal computer: 

• Sign off the host. 

• When a host signon screen appears, press Ctrl+Alt+Del. This 
returns you to DOS. The personal computer is offline. If you 
use the hot key sequence to enter personal computer mode 
instead of using the software reset sequence, memory space 
used by the Emulation Program may not be available for other 
application programs. 

Note: If you are running in a DOS session under OS/2, you can 
end the Emulation Program by doing one: 

• Hot key to the DOS prompt and type EXIT 

• From the Task list, click on the DOS session using the right 
mouse button and then select Close. 

See "Loading the Programs" on page 4-1 and "Starting the 
Emulation Program" on page 4-5 if you want to reload the Emulation 
Program. 

Using the Hot Key Sequence 

Warning: Do not use the DOS session while running the Emulation 
Program with OS/2. Entering any DOS command except EXIT (to 
end the Emulation Program) can cause unpredictable results. 

After the Emulation Program is loaded, the hot key sequence allows 
you to change sessions. By customizing the hot key sequence, it is 
possible to go directly to a particular session. (For information about 
customizing how keys are mapped, see "Changing the Keyboard 
Customization File" on page 6-8.) 

To leave emulation mode or to change emulation sessions, enter the 
hot key sequence. The emulated workstation remains online and the 
Emulation Program continues to run; however, the personal 
computer no longer displays the same session. 
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To leave personal computer mode, enter the hot key sequence. The 
current program is suspended until you hot key back to that mode. 

Notes: 

1. It is possible that your personal computer program may not allow 
itself to be interrupted. If this is true, let it run to completion 
before hot keying to an emulation session. 

2. You can read the information from a session screen and save it 
to disk. You may change the session that is selected to save 
screens. For more information about this and other sample 
programs, see "Example Emulation Program Utilities" on 

page D-3. 

3. Any host-issued commands that cause the personal computer to 
beep while the Emulation Program is online with the host 
continue to cause the unit to beep when it is in personal 
computer mode. This allows you to be aware of a host message 
or other event when you are not in emulation mode. 
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Chapter 5. Using the Display Screens 



The 25-line display in emulation mode displays 24 lines of data. Line 
25 is the status line and displays the status of the host and the 
personal computer. 



-80 Characters 



24 

Lines 



Status Line 



1c rr-cc SA MW KS IM II Sn KB 



Figure 5-1. Emulated 5250 Display Screen 
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Selecting the Cursor Style 

The cursor always blinks on the personal computer. The cursor's 
attributes can be changed between a blinking rectangle and a 
blinking underscore. Press Alt+F9 to toggle the cursor between a 
blinking rectangle and a blinking underscore. 

Note: A fast-cursor option is available by pressing the Alt key with a 
cursor movement key. 



Autodim Feature 

The Autodim feature automatically dims the screen after a specified 
length of time if no keystrokes are entered and no host-generated 
screen updates occur. During configuration, the Advanced Display 
Emulation Options Menu allows you to enable Autodim and specify 
the length of time. 



Changing Screen Colors 

You can change the foreground and background colors from the 
default green and black settings. 

To customize the screen colors, use the Customize Screen Colors 
and Attributes menu option under Advanced Display Options. For 
information about changing screen colors and attributes, see "Screen 
Colors and Attributes" on page 11-4. 
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Understanding the Status Indicators 

Status indicators are located on the status line (line 25) of the display 
screen when in emulation mode. 

Status Line 

1c rr-cc SA MW KS IM II Sn K 



Figure 5-2. Status Indicators 

The status indicators shown as capital letters appear either ON or 
OFF. The indicators are ON when a square block appears around 
the indicator. (The indicators are in reverse image.) 

Notes: 

1. When operating in 40-column mode, MW, KS, and IM indicators 
are not shown. 

2. Some of the indicators (such as the Ax indicator) are not 
normally seen on the status line. 

The status indicators and their meanings are shown on the following 
pages. 

Line Check Error (Ic) 

Ic The line check error shows the number of unrecognizable 

types of data that are received by the personal computer. The 
count appears as a decimal number in columns 1 and 2 on 
the status line. 

Note: This field is usually blank (no indicator appears). If a value 
appears in this field, see Appendix B, Problem Determination. 
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Cursor Location (rr-cc) 

The status line of the personal computer, when in emulation mode, 
describes the location of the cursor. Figure 5-3 shows where this 
information appears. 

The cursor location is displayed on the status line as two 2-digit 
numbers separated by a dash (the first two digits represent the row 
that the cursor is in, and the second two digits represent the 
column). 



Row 1 



Row 6 




Cursor 



Col umn Col umn 

15 30 



Row 24 

lc 06-30 SA MW KS IM II Sn KB 

Cursor Location 



Figure 5-3. Cursor Location on Screen 

For example, the cursor in the illustration is in row 6 and column 30. 
This would be displayed on your status line as 06-30. 
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System Available (SA) 

KTil The controller (5294 or 5394), the host, or both are operating 
and are available to the personal computer. 

SA The controller, the host, or both are not available to the 
personal computer. 

Message Waiting (MW) 

E2I The host has one or more messages for you. (You might 
hear a beep when the Message Waiting indicator first 
turns on.) 

MW The host does not have a message waiting for you. 
Keyboard Shift (KS) 

[9 The keyboard is in shifted mode. 

The KS indicator does not show when the keyboard is in Caps 
Lock or Num Lock mode. These modes are shown by lights 
on the IBM Personal Computer AT keyboard and the 
Enhanced keyboard. They are not shown on keyboards used 
by other IBM personal computers or the IBM Space Saving 
Keyboard. 

KS The keyboard is in nonshifted mode. 
Insert Mode (IM) 

IB! Characters can be inserted into an existing field without 
destroying existing data. 

IM Characters cannot be inserted into an existing field without 
destroying data. 

Input Inhibited (II) 

fTl Keyboard input is not being accepted by the host or the 
controller. 

II Keyboard input is being accepted by the host or the controller. 

If the session was configured for keystroke buffering and the II (Input 
Inhibited) indicator is on, keystrokes are saved and not sent to the 
host. When II is on, the only keystrokes sent to the host are Shift, 
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emulated Error Reset, emulated Attention, emulated System 
Request, and emulated Help. 

If keystrokes are saved, you may clear them by pressing the I Reset 
Key sequence. See "Special Key Sequences" on page 6-4 for 
information about the I Reset Key sequence. 

The II indicator is turned on by the host system or by the controller 
while it is processing your requests. The II indicator is also turned 
on by error conditions. 

The emulated Error Reset key may be used to turn the II indicator 
off, if it was turned on by an error condition. 

Session Number (Sn) 

Sn The session number appears as an S followed by the number 
of the currently displayed session, for example S1. 

Keystroke Buffering (KB) 

GJ Keystrokes are saved. When the input inhibited condition is 
cleared, they are sent to the host. If keystrokes are saved, 
you may clear them by pressing the I Reset Key sequence. 
See "Special Key Sequences" on page 6-4 for information 
about the I Reset Key sequence. 

KB No keystrokes are being saved. 

Note: The Keystroke Buffering indicator only appears during the 
sessions that you configured for buffering. (For information about 
running the configuration program to change keyboard buffering, see 
"Buffer Keystrokes" on page 11-2.) 

Workstation Address (Ax) 

Ax The workstation address is displayed to the right of the 
session number, in the location normally used to show 
keystroke buffering (KB). Pressing the WS Addr Key 
sequence causes the address to appear. Pressing the WS 
Addr Key sequence again returns the KB indicator (which is 
blank when keyboard buffering is not active) to the status line. 
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See "Special Key Sequences" on page 6-4 for information 
about the WS Addr Key sequence. 



Display Highlighting 

See the Technical Reference manual for a detailed description of the 
types of highlighting available for personal computer displays 
(compared with the 5250 displays) as used in the Emulation 
Program. 

Monochrome Displays 

The Emulation Program with the Monochrome Display Adapter can 
display characters that are normal intensity, high intensity, blinking, 
reverse image, or underscored. It does not provide characters that 
are in reverse image with underscore (it displays normal image with 
underscore) or reverse image with high intensity (it displays reverse 
image with normal intensity). 

Note: The highlighting for the Monochrome Display may be 
changed by using the configuration program. For information about 
changing screen attributes, see "Screen Colors and Attributes" on 
page 11-4. 

The Emulation Program does not support column separators in the 
same way as a 5250 Display Station. During the configuration 
program, you can select a personal computer character to be the 
column separator. You can also specify whether the character 
should appear when the field contains only a null character or when 
the field contains either a blank or null character. 

If you do not select a character as the column separator, a rectangle 
(|) appears in the separator position when it contains a null 
character. 
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The IBM 8507 Monochrome Monitor requires display attributes to be 
changed by the configuration program (CONFIG). Otherwise, the 
screen appears dim when emulation is loaded. The display option 
can be changed at the Advanced Display Emulation Options Menu 
during configuration. Refer to "Screen Colors and Attributes" on 
page 11-4, for more information. To prevent dimming on the 8507, 
change the following screen attributes: 

Enter OF for attribute 20. 
Enter 70 for attribute 21 . 
Enter 7F for attribute 22. 
Enter OF for attribute 30. 

Color Displays and Portable Displays 

Characters are displayed in normal intensity, high intensity, blinking, 
and reverse image when using the Emulation Program. 

The underscore is host program dependent. If the host program 
uses hex 00 in the data area of an underscored field, an underscore 
is simulated. If the host uses hex 40 (blank) in the data area, the 
underscore cannot be simulated. (The character appears without an 
underscore.) 

Notes: 

1 . The highlighting for a color display may be changed by using the 
configuration program. For information about changing screen 
attributes, see "Screen Colors and Attributes" on page 11-4. 

2. A display that uses the Color Graphics Adapter, but is identified 
as a single-color display or an IBM Portable Personal Computer 
display during configuration, may not have its attribute table 
changed. 

The Emulation Program does not support column separators in the 
same way as a 5250 Display Station. During the configuration 
program, you can select a personal computer character to be the 
column separator. You can also specify whether the character 
should appear when the field contains only a null character or when 
the field contains either a blank or null character. 
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If you do not select a character as the column separator, a rectangle 
(|) appears in the separator position when it contains a null 
character. 

If you are using the IBM Portable Personal Computer or a 
single-color monitor with a Color Graphics Adapter, you can set the 
correct display mode for the emulation sessions by using the 
CONFIG.EXE program as follows: 

1 . Select the Advanced Display Emulation Options on the 
Advanced Options Menu. 

2. Select Monitor Types for Color Graphics Adapter option. 

3. Indicate your monitor type. 

4. Return to the Advanced Display Emulation Options Menu. 

5. Save the profile data. 

The Emulation Program sets the display attributes and mode based 
on the profile data. 
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Chapter 6. Using the Keyboard 



When the personal computer emulates an IBM 5250 Display Station, 
the key assignments are not exactly the same as on a 5250 
keyboard. You can use any of the keyboard customization files that 
are supplied with the Emulation Program, or you can create your 
own. The profiles that are supplied with the program support the 
enhanced, PC/AT, and PC/XT*-style keyboards. See Figure E-2 on 
page E-4 for a list of supplied keyboard customization files. 

The key assignments are located as close to the normal key position 
as practical for each keyboard style. Figure E-1 on page E-1 shows 
how the 5250 functions are mapped to the enhanced, PC/XT, and 
PC/AT-style keyboards. 

You can use one of the supplied keyboard customization files or 
define your own keyboard customization file. For information about 
changing keyboard customization files, see "Changing the Keyboard 
Customization File" on page 6-8. For more detailed information 
about defining a keyboard, see the Technical Reference. 

Most keyboards for portable computers (laptops, notebooks, and so 
forth) support all the functions that are available on the IBM 
Enhanced Keyboard. However, to perform some of the functions, 
you have to use a combination of keys. For example, some 
keyboards do not have the right Ctrl key, which is used to enter data 
on the 5250 keyboard, but you can use a combination of keys 
(usually F/7+Ctrl) to simulate pressing the right Ctrl key. For 
information about how your keyboard is mapped, refer to the 
documentation for your computer. 

If an error is found in a keyboard customization file when the 
program is started, an error message is displayed and control is 
returned to DOS. 
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Figure 6-1 lists examples of the keyboard customization file required 
for each personal computer keyboard. The dashes in the file names 
are required because they are part of the keyboard customization file 
naming convention. For a list of keyboard customization files that 
are provided with the Emulation Program, see "Keyboard 
Customization Files" on page E-3. 



Figure 6-1. Keyboard Customization Files 


Personal Computer Keyboard 


Keyboard Style 


Example 


IBM PC, PC/XT, Portable PC 


PC/XT style 


US— --P.PRO 


IBM PC/AT 


PC/AT style 


US- — A.PRO 


IBM Enhanced, IBM Space Saving 


Enhanced style 


US— --E.PRO 


IBM ThinkPad* 


Enhanced style 


US— -E.PRO 



You can also create your own keyboard customization file by using a 
text editor to change one of the provided keyboard customization 
files. For information about creating your own keyboard 
customization file, see "Changing the Keyboard Customization File" 
on page 6-8. 



Keyboard Modes 

The keyboard mode controls the characters or functions desired 
when pressing a given key. The keyboard is used in four different 
modes: 

• Alternate mode (Alt key) 

• Shifted mode 

- Shift key held affects all keys 

- Caps Lock state affects only alphabetic keys 

- Num Lock state affects only numeric pad keys 

- Shift Lock state affects alphabetic and special character keys 

• Nonshifted mode 
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For example, on the enhanced style keyboard: 



Keys 



Function 



Alt+Prtsc 

Shift+Prtsc 

Prtsc 



System Request 
Host print screen 
PC print screen 



For illustrations of the supported keyboard layouts for enhanced style 
keyboards, see "Keyboard Layouts" on page E-5. 

Nonshifted Mode 

The nonshifted mode is the normal mode of a keyboard. As with a 
typewriter, when the Shift key is not pressed, the caps lock and shift 
lock functions are not active. In this mode, pressing the a key 
displays an a. 

Shifted Mode 

The shifted mode is the mode of a keyboard when the Shift key is 
held down or when an emulated shift lock function is active. As with 
a typewriter, when the Shift key is pressed or the shift lock is active, 
pressing the a key displays an A. 

Caps Lock State 

In the caps lock state, only the alphabetic characters enter 
uppercase characters. This state remains in effect during all 
emulated sessions and when in PC DOS mode. The indicator that is 
on the IBM Personal Computer AT Keyboard and IBM Enhanced 
Keyboard is on when the caps lock state is in effect. 

Shift Lock State 

In the shift lock state, the entire keyboard enters uppercase 
alphabetic characters and the shifted characters on special character 
keys. 
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Num Lock State 

The function or character assigned to the shifted state on the 
numeric keyboard is performed. This state remains in effect during 
all emulated sessions and when in PC DOS mode. The indicator on 
the following keyboards is on when the Num Lock state is in effect: 

• IBM Enhanced Keyboard 

• IBM Personal Computer AT Keyboard 

Alternate Mode 

The alternate mode is the mode of a keyboard when the Alt key is 
held down. Like the Shift key, the Alt key provides another level of 
shift for the keyboard. 



Special Key Sequences 
Hot Key Sequence 

The hot key sequence is used to change sessions. Each time the 
emulated hot key sequence is pressed, the session is changed to the 
requested session or to the next session in the defined rotation. An 
example of that rotation is shown in Figure 6-2. Each time the 
emulated hot key sequence is pressed, the display shows the next 
session. The default hot key sequence is Alt+Esc. By using 
keyboard customization, it is possible to go directly to a desired 
session. For information about changing the default hot key 
sequence, see "Changing the Keyboard Customization File" on 
page 6-8. For detailed information about changing the hot key 
sequence, see the Technical Reference manual. 

I — FIRST SESSION— ►(Hot Key) — SECOND SESSION-, 



1 (Hot Key)* PC MODE-* (Hot Key) 

Figure 6-2. Hot Key Session Rotation 
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Notes: 



1 . Occasionally, when the emulated hot key sequence is entered, 
the request may not be accepted. Enter the sequence again 
until your request is accepted. 

2. After a hot key, all keys used in the hot key sequence must be 
released before another hot key can be attempted. 

3. You should be aware that any key sequence you assign in a 
keyboard customization file to hot key from the DOS session is 
not available for use in a DOS application program. The hot key 
sequence is detected by the Emulation Program and the keys 
are not passed on to the DOS application. 

4. It is possible that your PC DOS application may not allow itself to 
be interrupted. If this is true, you should let it run to completion 
before hot keying to an emulation session. 

Immediate Reset Key Sequence 

The Immediate Reset (I Reset) key sequence is used to clear the 
keystroke buffer and to stop the playback of any defined key 
sequences. I Reset also clears any Shift Lock or Insert mode states 
that are in effect. To enter the I Reset Key sequence, press and 
hold the Alt key and then press the Scroll Lock key. 

Workstation Address Key Sequence 

The Workstation Address (WS Addr) key sequence is used to display 
the 5250 workstation address for the current emulated session. To 
enter the WS Addr key sequence, press and hold the Alt key and 
then press the Ctrl key. The address is displayed to the right of the 
session number, in the location normally used to show keystroke 
buffering (KB). Entering the WS Addr key sequence again returns 
the KB indicator to the status line. The KB indicator may be blank if 
keyboard buffering is not active. 
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Using the Shift Lock Functions 



Using the Shift Lock Key 

On some national language keyboards, the Caps Lock key is 
replaced with a Shift Lock key. When you press the Shift Lock key, 
the uppercase alphabetic characters (A through Z) and the special 
characters (like the @ symbol) are entered, but the function keys 
continue to use the functions assigned to the nonshifted mode. See 
"Entering the Keyboard Functions" on page 6-7 for additional 
information. 

Using the Caps Lock and Num Lock Keys 

When operating with the personal computer style keyboards, the 
Caps Lock and the Num Lock keys operate the same as in PC DOS 
mode. Pressing the keys in any of the sessions, including the DOS 
session, sets the state in all sessions. The states of the Caps Lock 
and Num Lock keys are shown on the Personal Computer AT 
keyboard and the Enhanced Keyboard. Neither Caps Lock nor 
Num Lock may be used in a playback sequence. 

When in Caps Lock, the uppercase characters (A through Z) and the 
lowercase special characters (like the number 2) are entered, and 
the function keys continue to use the functions assigned to the 
nonshifted mode. Caps Lock does not cause the KS indicator to 
come on. The Caps Lock function can only be assigned to the Caps 
Lock key. 

When in Num Lock, the characters or functions assigned to the 
shifted mode of the numeric pad are entered. Num Lock does not 
cause the KS indicator to come on. The Num Lock function can only 
be assigned to the Num Lock key. 

See "Entering the Keyboard Functions" on page 6-7 for more 
information. 
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Entering the Keyboard Functions 

When a key is pressed in the shifted mode, the character or function 
defined to the "s-" (shifted) mode of the key is entered. When a key 
is pressed in the alternate mode, the character or function defined to 
the "a-" (alternate) mode of the key is entered. 

For example, if you made the following definitions in the keyboard 
customization file: 

def 1 = T 

def s-1 = '!' 

def Ctrl = [attn] 

def s-Ctrl = [sys req] 

when the keyboard is in the shifted mode (Shift key held down or 
keyboard in emulated shift lock state) and the 1 key is pressed, the ! 
is entered because ! is a defined character. 

Keys defined to perform functions when in the shifted state perform 
those functions only when the Shift key is held down or the key is on 
the numeric pad and the keyboard is in the Num Lock state. For 
example, with the above key definitions, when Ctrl (the emulated Attn 
key) is pressed, the attention function is requested of the host 
system when the keyboard is in the nonshifted state. To use the 
system request function, you may press Ctrl (the emulated Sys Req 
key) while a Shift key is held down. 

When a personal computer style keyboard is in the caps lock state, 
an a is entered as an A, however a 1 is entered as a 1 because 
these are the personal computer defined characters. 

Keys defined to perform functions when in the shifted state must 
have the Shift key held down, even when the keyboard is in caps 
lock state. For example, with the above key definitions, when Ctrl 
(the emulated Attn key) is pressed, the attention function is 
requested of the host system whether or not you are in caps lock 
state. To use the system request function, you must press Ctrl (the 
emulated Sys Req key) while a Shift key is held down. 
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Keystroke Buffer 

If keystroke buffering is configured for a session and the Input 
Inhibited (II) indicator is on, keystrokes (up to 32) are stored and 
then sent to the host when the Input Inhibited indicator is off. If more 
than 32 keys are pressed, an alarm is sounded for each key and the 
keystroke is discarded. As the buffer space is freed, when 
keystrokes are sent to the host, additional keystrokes may be 
buffered. 

See "Keystroke Buffering (KB)" on page 5-6 for a description of the 
Keystroke Buffer indicator. 

If keystrokes are stored and you want to cancel them, do one of the 
following: 

• Press and release the emulated Error Reset key. 

• Press and hold the I Reset Key sequence. This method also 
stops any playback sequence that is in progress. 

The stored keystrokes are removed from the keystroke buffer, an 
emulated Error Reset is sent to the host, and Shift Lock and Insert 
states are cleared. 

Note: While running 3270 emulation on the IBM host, the Input 
Inhibited indicator may be cleared when the system is not ready to 
accept keystrokes. Clearing Input Inhibited may cause buffered 
keystrokes to be discarded. Care should be taken when buffering 
keystrokes for use during 3270 emulation. 



Changing the Keyboard Customization File 

You can change character and function assignments by changing the 
keyboard customization files. For example, if you wanted to change 
the hot key sequence that you use to switch between the DOS and 
5250 sessions, you would change the keyboard customization file. 

You must customize your keyboard customization file before starting 
the Emulation Program. When you start the Emulation Program, the 
keyboard customization file takes effect. 
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The keyboard customization files are ASCII text files that you can 
edit using any ASCII editor, like EDIT that comes with DOS. Each 
definition in the keyboard customization file must be entered on one 
line. The syntax of the DEFINE command is: 

DEF mode keyname = function 

or 

DEF mode keyname = text 



Where: 
mode 



Specifies whether only the key is pressed or the key is 
pressed with the Shift key or the Alt key. The values for 
mode are: 

(blank) For non-shifted mode (only the key is pressed) 
s- For shifted mode (the key and Shift are 

pressed) 

a- For alternate mode (the key and Alt are 

pressed) 

keyname The name of one of the personal computer keys. For the 
keyname, you can use any character on your keyboard or 
any key name that is listed in Figure 6-3 on page 6-10. 
For example, def a = b 

function The name of one of the host functions. For a list of host 
function names, see Figure 6-4 on page 6-1 1 . 

text A string of characters that is enclosed in quotation marks. 
You can use single (') or double (") quotation marks 
around the string. For more information about using text, 
see "Assigning Text to a Key" on page 6-1 1 . 



For example, if you wanted to be able to print the current host 
screen by pressing the Shift and F1 keys, you would put the 
following definition in your keyboard customization file: 

def s-f l=[printhost] 

Or, if you wanted to be able to switch between the DOS and 5250 
sessions by pressing Alt+t, you would put the following definition in 
your keyboard customization file to add the hot key sequence: 

def a-t= [hotkey] 
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Notes: 

1 . You can define more than one hot key sequence. 

2. For additional information about customizing your keyboard, see 
the Technical Reference manual. 



Figure 6-3. Personal Computer Key Names 



alt 


alt2 


backspace 


capslock 


Ctrl 


ctrl2 


delete 


down 


end 


enter 


esc 


f1 


f2 


f3 


f4 


f5 


f6 


f7 


f8 


f9 


no 


f11 


f12 


home 


insert 


left 


numlock 


pad* 


pad+ 


pad- 


pad. 


pad/ 


padO 


pad1 


pad2 


pad3 


pad4 


pad5 


pad6 


pad7 


pad8 


pad9 


padenter 


pause 


pgdn 


pgup 


prtsc 


right 


scrollock 


space 


sysreq 


tab 


up 
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Figure 6-4. Host Function Names 



alt 


altgr 


attn 


backspace 


backtab 


capslock 


clear 


cmdl 


cmd2 


cmd3 


cmd4 


cmd5 


cmd6 


cmd7 


cmd8 


cmd9 


cmd10 


cmdl 1 


cmd12 


cmd13 


cmd14 


cmd15 


cmd16 


cmd17 


cmd18 


cmd19 


cmd20 


cmd21 


cmd22 


cmd23 


cmd24 


cursor 


delete 


down 


dup 


enter 


eraseinput 


field+ 


field- 


fieldexit 


help 


hex 


home 


hotkey 


hotkeyl 


hotkey2 


hotkeyd 


insert 


inserttoggle 


left 


newline 


numlock 


pad. 


padO 


pad1 


pad2 


pad 3 


pad4 


pad5 


pad6 


pad7 


pad8 


pad9 


printhost 


printpc 


reset 


right 


rolldown 


rollup 


shiftlock 


shifttoggle 


space 


sysreq 


tab 


testreq 


up 







Assigning Text to a Key 

The keyboard customization file allows you to assign a string of 
characters and functions to the alternate mode of a key. You can 
define up to a total of 510 characters to one or more keys. For 
example, if you wanted to enter Have a nice day every time you 
pressed Alt+h, you would add the following definition to your 
keyboard customization file: 

def a-h = 'Have a nice day' 

If the string that you are assigning to a key contains quotation marks, 
begin and end the string with a different type of quotation mark. For 
example: 

def a-s="Bob's name" 
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If a key does not have a string assigned to its alternate mode, the 
keystroke buffer is cleared when you press Alt with that key. No 
additional action occurs. 

Notes: 

1 . You can only assign multiple keystroke sequences during 
keyboard customization. 

2. You should not assign strings, such as security code strings, that 
you do not want displayed. Strings that are assigned to the 
alternate mode of keys can be played back in a displayable field. 

3. While running 3270 emulation on the IBM host, the Input 
Inhibited indicator might be cleared when the system is not ready 
to accept keystrokes. Clearing Input Inhibited can cause 
playback sequence keys to be discarded. Be careful when 
defining playback sequences for use during 3270 emulation. 

4. For more information about customizing your keyboard, see 
"Changing the Keyboard Customization File" on page 6-8. For 
more detailed information, see the Technical Reference manual. 
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Chapter 7. Emulating an IBM 5219 Printer 



The personal computer printers listed in Figure 7-1 are capable of 
emulating the 5219 printer when used with a supplied PFT. If the 
supplied PFT for your printer is listed as Internal, select your printer 
from the Attached Printer List screen during session configuration. 



Figure 7-1 (Page 1 of 2). PC Printers That Can Emulate 5219 
Printers 


Personal Computer Printer 


Supplied PFT 


IBM Personal Printer Series (IBM 2380, IBM 
2380 Plus, IBM 2381, IBM 2381 Plus, IBM 
2390, IBM 2390 Plus, IBM 2391, and IBM 
2391 Plus) 


IBM2390.PFT 


IBM 3812 Pageprinter 


IBM3812.PFT 


IBM 4019 and 4029 Laser Printers 


IBM4019.PFT 
(TOr rrUb) 

HPLASER2.PFT 
(for PCL)1 


IBM 4039 Laser Printer 


PCL5.PFT 2 


IBM 4037 5E Printer 


IBM4019.PFT 


IBM 4070 IJ Printer 


IBM4208.PFT 


IBM 4072 ExecJet Printer 


IBM4072.PFT 


IBM 4076 ExecJet II Printer 


IBM4207.PFT 
(for PPDS) 
HPLASER2.PFT 
(for PCL) 1 


IBM 4202 Proprinter XL 


IBM4202.PFT 


IBM 4207 Proprinter X24 


IBM4208.PFT 


IBM 4208 Proprinter XL24 


IBM4208.PFT 


IBM 4212 Proprinter 24P 


IBM4212.PFT 



1 The HPLASER2.PFT requires the Roman 8 symbol set to be in your printer. 

2 The PCL5.PFT requires the PC-850 symbol set to be in your printer. 
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Figure 7-1 (Page 2 of 2). PC Printers That Can Emulate 5219 
Printers 


Personal Computer Printer 


Supplied PFT 


IBM 4226 Printer 


IBM4226.PFT 


IBM 5182 Color Printer 


Internal 


IBM 5201 Quietwriter 


Internal 


IBM 5202 Quietwriter III 


IBM5202.PFT 


IBM 5204 Quickwriter 


IBM5204.PFT 


IBM 5216 Wheelprinter 


Internal 


HP LaserJet Printer Series II and III 


HPLASER2.PFT 3 


HP LaserJet 4 


PCL5.PFT 4 


User-defined printer 


Internal 



Introducing 5219 Emulation 

One of the above printers can be used to emulate the IBM 5219 
Printer when the second session of the Emulation Program is 
configured for 5219 printer emulation. Any printer capable of 
emulating a 5219 may be attached. However, functions not available 
on the 5219 are not supported, even though the attached printer may 
support them. 

For example, a 3812 emulating the 5219 is different from a 3812 
directly attached to the host. This means that 3812 functions, such 
as the Set Text Orientation command, are not supported. 



3 The HPLASER2.PFT requires the Roman 8 symbol set to be in your printer. 

4 The PCL5.PFT requires the PC-850 symbol set to be in your printer. 
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Notes: 

1 . The keyboard customization file in effect for the display 
emulation session is also in effect for printer emulation. 

2. Printer emulation continues when in personal computer mode. If 
the printer is used in personal computer mode, printer emulation 
must be suspended before leaving the printer emulation session. 

The 5219 printer emulation uses information from the session profile. 
See "Configuring for Emulation" on page 3-25 for further information. 
Refer to the Technical Reference manual for descriptions of 
commands that control the 5219. 

The personal computer display screens emulate the IBM 5219 printer 
operator panel while in IBM 5219 printer emulation mode. 

Using the HP LaserJet and IBM 4039 Printers 

The HP LaserJet printers and IBM 4039 printers use an IBM-supplied 
Printer Function Table (PFT). When using this PFT: 

• Superscript and subscript only work with a line density of 6 lines 
per inch. 

• Proportional space fonts do not print correctly when text is 
underlined or overstriked. 

• Justification is not supported when using proportional spaced 
fonts. 

• Tabs are not supported when using proportional spaced fonts. 

• Mid-line type style changes do not print correctly when either of 
the type styles is typographic. 

• Bold print and set text orientation (rotate page) are not 
supported. 



Chapter 7. Emulating an IBM 5219 Printer 7-3 



Setting Up the Printer 

The Emulation Program sets up the attached personal computer 
printer according to options chosen during configuration. You can 
specify the type of paper feed the printer can use, paper width, form 
feed, and font change without user intervention. (See "Advanced 
Printer Options" on page 11-8 for more information.) 

Each defined printer session requires a separate printer. You are 
responsible for ensuring that the physical paper handling equipment 
matches what was specified during configuration. 



Automatic Cut Sheet Feed Handling Device 

An IBM 5219 Printer initializes the paper feed technique of the Set 
Print SetUp (SPSU) control to whatever paper feed hardware is 
electrically connected to the 5219 Printer. 5219 emulation initializes 
the paper feed technique to the first paper feed type specified in the 
host print job. 

Refer to the printer operator's guide when physically setting up the 
cut sheet feed handling device. 

If an IBM 5216 Wheelprinter is attached, the Paper Feed Toggle 
switch must be set for the desired sheet feed method. 



Serial Printer Limitations 

If you will be using a serial printer, you should be aware of the 
following limitations: 

• No other communications adapters (SDLC, BSCA, and so forth) 
can be used concurrently in the personal computer. 

• Only one Asynchronous Communications Adapter may be in use 
in the personal computer. 

• The printer emulation code cannot detect the difference between 
"Printer Off Line" or "Paper End" conditions in the serial printer. 

If either condition occurs, printer emulation shows "Printer Off 
Line." The printer Emulation Program tries to send data to the 
printer until all the data is successfully transmitted. 
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• Baud rate is limited to a maximum of 4800 when running on the 
IBM Personal Computer, the IBM Portable Personal Computer, 
or the IBM Personal Computer XT. It is your responsibility to 
make sure this rate is not exceeded. 

If, during initialization, the printer Emulation Program detects that 
this limitation is exceeded, 4800 baud is used instead of the 
selected baud rate and unexpected results might occur. 



5219 Printer Emulation Display 

The options and indicators are shown in Figure 7-2. 



5219 PRINTER EMULATION 


- OPERATOR SCREEN 


OPTION MENU: 


INDICATORS: 


1 Start 


Ready 


2 Stop 




3 Suspend 


Printer Exception 


4 Cancel 






End Of Forms 


Output Data = [ ] 


Change Setup 




Change Font 


SELECT OPTION 


System Available 




S2 



Figure 7-2. 5219 Printer Emulation — Operator Screen 



Using the Emulated Printer Options 

The 5219 Printer Emulation — Operator Screen emulates the Start, 
Stop, and Cancel switches on the printer operator panel and uses 
the following options: 

• Start 

• Stop 
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• Suspend 

• Cancel 

To select an option, type the associated number and then press 
Enter. 

Note: Before turning off your personal computer, you must sign off 
from your printer session. 

Start Option 

Selecting the Start option while the Ready indicator is on carries out 
no function because its intended function is to make the printer 
Emulation Program ready to print. 



If the Ready indicator is OFF when the Start option is selected, the 
result depends on the condition of the printer Emulation Program, as 
shown in Figure 7-3. 



Figure 7-3. Start Option 


Condition 


Result 


Emulation Program is 
loaded and no error 
conditions exist. 


Turns the Ready indicator on. 


Printer Emulation 
Program was 
stopped by the Stop 
option. 


Turns the Ready indicator on and allows 
printing to continue. 


Printer Emulation 
Program was 
stopped by the 
Suspend option. 


Turns the Ready indicator on, returns printer 
control to the printer Emulation Program, 
restores the printer to the state it was in at the 
time the Suspend option was selected, and 
allows printing to continue. The current print 
line becomes the logical top of the page. 
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Stop Option 

Selecting the Stop option while the Ready indicator is on causes the 
Ready indicator to be turned off. The printer continues printing until 
its buffer is empty. The printer Emulation Program does not process 
any further data or commands from the host until the Start option is 
selected. 

This option is intended to temporarily stop printing to allow 
adjustments to the printer, such as changing paper. 

Suspend Option 

Selecting the Suspend option while the Ready indicator is on causes 
the Ready indicator to be turned off and all information in the 
printer's print buffer to be printed. No further host data or commands 
are processed by the printer Emulation Program. 

In addition, the current status of the emulated 5219 printer is saved, 
the forms advance to the first print line of a new page, the personal 
computer is initialized to its power-on state, and all operator panel 
options, except Start, are disabled. This option allows you to free 
the printer from the host and make it available to the personal 
computer. Use the hot key sequence to go to personal computer 
mode. 

After the hot key sequence, you can move the forms to any desired 
position and use the printer for any personal computer printing. 
When finished, you should position the forms to the first print line of 
a new page. 

The Suspend option is accepted regardless of the state of the Ready 
indicator. 

Note: This option is necessary only if the personal computer 
application program uses the same printer device name (LPT1 , 
LPT2, and so on) as the Emulation Program (selected via the 
configuration program). If the application program is using a different 
printer, then the Emulation Program can print at the same time as 
the application program without being suspended. 
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Cancel Option 

Selecting the Cancel option causes the host to be notified of the 
cancel request. 

This option is accepted regardless of the state of the Ready 
indicator. 

Output Data Field 

The output data field provides you with control and diagnostic 
information. See Figure A-1 on page A-7 for a description of the 
codes. 

Status Indicators 

The operator panel emulates the following status indicators: 

• Ready 

• Printer Exception 

• Forms 

• Change Setup 

• Change Font 

• System Available 

When an emulated indicator is on, it appears in reverse image on the 
options screen. 

Ready Indicator 

The Ready indicator is turned on by selecting the Start option or by 
receiving a Set Mode command from the host when the printer is 
online. Whenever the indicator is on, the printer Emulation Program 
is ready to process host data and the printer is ready to receive the 
data. 

The Ready indicator is turned off by one of the following: 

• Change font request 

• Change setup request 

• Reset command from the host 

• End of forms condition 
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• Printer exception 

• Data transfer error 

You can turn it off by selecting the Stop or Suspend option. 
Printer Exception Indicator 

The Printer Exception indicator turns on when a data stream 
exception is detected. The 2-digit code that appears in the output 
data field defines the exception. See Figure A-1 on page A-7 for a 
description of the codes. 

Forms Indicator 

The Forms indicator is turned on when either an automatic sheet 
feed drawer is empty or the printer is out of continuous forms. 

See the appropriate printer operator's guide for paper handling 
procedures. The printer Emulation Program must be made ready by 
selecting the Start option to continue printing. 

Change Setup Indicator 

The Change Setup indicator is turned on when a request is received 
to change the paper feed method. The 2-digit code that appears in 
the output data field describes the paper feed mechanism requested. 
See Figure A-1 on page A-7 for a description of the codes. See the 
operator's guide for your printer to change the paper feed hardware. 

Change Font Indicator 

The Change Font indicator is turned on when a request is received 
to change the font. The 2-digit code that appears in the output data 
field describes the requested font. See Figure A-1 on page A-7 for 
a description of the codes. 

Note: This indicator is not used with a printer that can change fonts 
without user intervention (specified when you configure advanced 
printer options). 
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System Available Indicator 

The System Available indicator is turned on whenever a printer 
command, other than a Reset command, is received from the host. 

This indicator is turned off when communication with the host stops. 

Printer Session Number (Sn) 

The printer session number appears on line 25 as Sn (where n is the 
number of the session). 

Workstation Address (Ax) 

The printer workstation address is displayed on the emulated control 
panel. Pressing the WS Addr key sequence again removes the 
address from the emulated control panel. 



User-Defined Printer 

The Emulation Program allows you to make a non-supported printer 
class known to the program. To do this, you create a printer function 
table that the Emulation Program uses to convert controls into the 
escape sequences, controls, and graphics understood by the printer. 

For information about creating printer function tables, see 
Chapter 10, "Using the Printer Function Table Setup Program." 
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Chapter 8. Emulating an IBM 5224 Printer 



Note: All the information in this chapter about the 5224 printer 
applies to the 5225 printer. 

The personal computer printers listed in Figure 8-1 are capable of 
emulating the 5224 printer when used with a supplied PFT. If the 
supplied PFT for your printer is listed as Internal, select your printer 
from the Attached Printer List screen during session configuration. 



Figure 8-1 (Page 1 of 2). PC Printers That Can Emulate 5224 
Printers 


Personal Computer Printer 


Supplied PFT 


IBM Personal Printer Series (IBM 2380, IBM 
2380 Plus, IBM 2381, IBM 2381 Plus, IBM 

O^QH IRM 01Qf\ Pine IRM O^Q1 anrl IRM 
£-OyU, IDIVI *Z\Di)v rlUo, IDIVI £oi) \ , dllu IDIVI 

2391 Plus) 


IBM2390.PFT 


IBM 3812 Pageprinter 


IBM3812.PFT 


IBM 4019 and 4029 Laser Printers 


IBM4019.PFT 
(for PPDS) 
HPLASER2.PFT 
(for PCL)i 


IBM 4039 Laser Printer 


PCL5.PFT 2 


IBM 4037 5E Printer 


IBM4019.PFT 


IBM 4070 IJ Printer 


IBM4208.PFT 


IBM 4072 ExecJet Printer 


IBM4072.PFT 


IBM 4076 ExecJet II Printer 


IBM4207.PFT 
(for PPDS) 
HPLASER2.PFT 
(for PCL)1 


IBM 4201 Proprinter 


Internal 


IBM 4202 Proprinter XL 


IBM4202.PFT 



1 The HPLASER2.PFT requires the Roman 8 symbol set to be in your printer. 

2 The PCL5.PFT requires the PC-850 symbol set to be in your printer. 
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Figure 8-1 (Page 2 of 2). PC Printers That Can Emulate 5224 
Printers 


Personal Computer Printer 


Supplied PFT 


IBM 4207 Proprinter X24 


IBM4208.PFT 


IBM 4208 Proprinter XL24 


IBM4208.PFT 


IBM 4212 Proprinter 24P 


IBM4212.PFT 


IBM 4226 Printer 


IBM4226.PFT 


IBM 5152 Matrix Printer (Model 001) 


Internal 


IBM 5152 Graphics Printer (Model 002) 


Internal 


IBM 5182 Color Printer 


Internal 


IBM 5201 Quietwriter 


Internal 


IBM 5202 Quietwriter III 


IBM5202.PFT 


IBM 5204 Quickwriter 


IBM5204.PFT 


IBM 5216 Wheelprinter 


Internal 


HP LaserJet Printer Series II and III 


HPLASER2.PFT 3 


HP LaserJet Printer 4 


PCL5.PFT 4 


User-defined printer 


Internal 



Introducing 5224 Emulation 

One of the above printers can be used to emulate the IBM 5224 
Matrix Printer when the second session of the Emulation Program is 
configured for 5224 printer emulation. Any PC attached printer 
capable of emulating a 5224 may be attached. However, functions 
not available on the 5224 are not supported, even though the 
attached printer may support them. 

For example, a 3812 emulating the 5224 is different from a 3812 
directly attached to the host. This means that 3812 functions, such 



3 The HPLASER2.PFT requires the Roman 8 symbol set to be in your printer. 

4 The PCL5.PFT requires the PC-850 symbol set to be in your printer. 
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as bold printing and the Set Text Orientation (landscape) command, 
are not supported. 

Notes: 

1 . The keyboard customization file in effect for the display 
emulation session is also in effect for printer emulation. 

2. Printer emulation continues when in personal computer mode 
unless the printer session is suspended before entering that 
mode. 

3. Transparent mode or Buffer Print is not supported with the 
Emulation Program. 

4. Load Alternate Character (LAC) is not supported with the 
Emulation Program. This means that the System/36 5224 
Advanced Printer Function licensed program is not supported. 

The 5224 printer emulation uses a session profile. (See "Configuring 
for Emulation" on page 3-25 for further information.) 

In printer emulation mode, the personal computer display screen 
emulates the operator panel on an IBM 5224 printer. See the 
Technical Reference for commands to control the 5224 printer. 



Serial Printer Limitations 

If you will be using a serial printer, you should be aware of the 
following limitations: 

• No other communications adapters (SDLC, BSCA, and so on) 
may be used concurrently in the personal computer. 

• Only one Asynchronous Communications Adapter may be in use 
in the personal computer. 

• The printer emulation code cannot detect the difference between 
"Printer Off Line" or "Paper End" conditions in the serial printer. 

If either condition occurs, printer emulation shows Printer Off 
Line. The printer Emulation Program tries to send data to the 
printer until all the data is successfully transmitted. 
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• Baud rate is limited to a maximum of 4800 when running on the 
IBM Personal Computer, the IBM Portable Personal Computer, 
or the IBM Personal Computer XT. It is your responsibility to 
make sure this rate is not exceeded. 

If, during initialization, the printer Emulation Program detects that 
this limitation is exceeded, 4800 baud is used instead of the 
selected baud rate and unexpected results might occur. 



Setting Up the Printer 

The Emulation Program sets up the attached personal computer 
printer according to options chosen during configuration. LPI, CPI, 
paper width, form feed, and font changes without user intervention 
can be specified. (See "Advanced Printer Options" on page 11-8 for 
more information.) 

Each defined printer session requires a separate printer. 
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5224 Printer Emulation Display 

The options and indicators are shown in Figure 8-2. 



5224 PRINTER EMULATION 


- OPERATOR SCREEN 


OPTION MENU: 


INDICATORS: 


1 Start 


Ready 


2 Stop/ Reset 




3 Suspend 


Attention 


4 Cancel 




5 Line Feed 


Forms 


6 Form Feed 




7 Select Printer Parameters 


Graphic Check 


Output data ( ) 


Change Font 


SELECT OPTION 


System Available 




S2 



Figure 8-2. 5224 Printer Emulation — Operator Screen 



Using the Emulated Printer Options 

The 5224 Printer Emulation — Operator Screen emulates the operator 
panel on the printer and uses the following options: 

• Start 

• Stop/Reset 

• Suspend 

• Cancel 

• Line Feed 

• Form Feed 

• Select Printer Parameters 

To select an option, type the associated number and then press 
Enter. 
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Start Option 

Selecting the Start option while the Ready indicator is on carries out 
no function because its intended function is to make the printer ready 
to print. 



If the Ready indicator is off when the Start option is selected, the 
result depends on the condition of the printer emulation routine, as 
shown in Figure 8-3. 



Figure 8-3. Start Option 


Condition 


Result 


Emulation Program is loaded and 
no error conditions exist. 


Turns the Ready indicator on. 


Printer Emulation Program was 
halted by the Stop/Reset option, 
or the Stop/Reset option was 
used to reset an error condition. 


Turns the Ready indicator on and 
continues printing. 


Printer Emulation Program was 
halted by the Suspend option. 


Turns the Ready indicator on, 
returns personal computer printer 
control to 5224 printer emulation, 
restores the printer to the state it 
was in at the time the Suspend 
option was selected, and 
continues printing. The current 
print line becomes the logical top 
of page. 



Stop/Reset Option 

Selecting the Stop/Reset option while the Ready indicator is on 
causes the Ready indicator to be turned off. The printer continues 
printing until its buffer is empty. The Emulation Program does not 
process any further commands from the host until the Start option is 
selected. 

If this option is selected when the Ready indicator is off, it functions 
as a Reset key. 

This option is intended to temporarily stop printing and allow 
adjustments to the printer, such as changing paper. 
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Suspend Option 

Selecting the Suspend option while the Ready indicator is on causes 
the Ready indicator to be turned off and all information in the 
printer's print buffer to be printed. The Emulation Program does not 
process any further data or commands from the host. 

In addition: 

• The current status of the emulated 5224 printer is saved. 

• The forms advance to the first print line of a new page. 

• The printer enters its initialized state (Ready and Online). 

• All operator panel options, except Start, are disabled. 

This option allows you to free the printer from the host and make it 
available to the personal computer. Use the hot key sequence to go 
to personal computer mode. 

After the hot key sequence, you can move the forms to any position 
and use the printer for any personal computer printing. When 
finished, you should position the forms to the first print line of a new 
page. 

The Suspend option is accepted regardless of the state of the Ready 
indicator. 

Note: This option is necessary only if the application program uses 
the same printer device name (LPT1 , LPT2, and so on) as the 
Emulation Program (selected using the configuration program). If the 
application program is using a different printer, then the Emulation 
Program can print at the same time as the application program 
without being suspended. 

Cancel Option 

Selecting the Cancel option causes the host to be notified of the 
cancel request. 
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Line Feed Option 

Selecting the Line Feed option when the Ready indicator is off 
advances the forms to the next print line. 

The Line Feed option is ignored when the Ready indicator is on. 

Form Feed Option 

Selecting the Form Feed option when the Ready indicator is off 
advances the forms to the first print line of the next form. 

The Form Feed Option is ignored when the Ready indicator is on. 

Note: The operation of this option depends on previous commands 
to the printer. That is, the form length assigned by the host program 
must be the same as the actual length of the form. 



Printer Parameters 

The printer parameters appear as shown in Figure 8-4. If the host 
sends an LPI or CPI command to the printer, it overrides the 
parameter you selected. 



5224 PRINTER EMULATION - PRINTER PARAMETERS 

SELECT LINES PER INCH (LPI) 

1 6 LPI [ACTIVE] 

2 8 LPI 

SELECT CHARACTERS PER INCH (CPI) 

3 Normal (10 CPI) 

4 Compressed (15 CPI) [ACTIVE] 

5 Return to Operator Panel 
SELECT OPTION 

OPERATOR MESSAGE FIELD S2 



Figure 8-4. Emulated IBM 5224 Printer Parameters 
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Lines Per Inch (LPI) 



6 LPI Option 

Selecting 6 LPI (lines per inch) causes the printer to print six lines of 
text per inch of page length. 

8 LPI Option 

Selecting 8 LPI (lines per inch) causes the printer to print eight lines 
of text per inch of page length. 

Note: The current line spacing option is shown with the word 
ACTIVE appearing next to the option selected. 

Characters Per Inch (CPI) 
10 CPI Option 

Selecting 10 CPI (characters per inch) causes the printer to print 10 
characters per inch. If the attached printer has an 8-inch paper width 
and more than 80 characters are formatted for a line, the extra 
characters are printed on the following line. 

15 CPI Option 

Selecting 15 CPI causes the printer to print 15 characters per inch 
(compressed print). When the attached printer has an 8-inch paper 
width, this option allows 132 characters to be printed on a line. 

Note: The current character spacing option is shown with the word 
ACTIVE appearing next to the options selected. 

Output Data Field 

The Output Data field provides control and diagnostic information to 
operators. See Figure A-1 on page A-7 for a description of the 
codes. 

Status Indicators 

The emulated operator panel emulates the following status 
indicators: 

• Ready 

• Attention 

• Forms 
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• Graphics Check 

• Change Font 

• System Available 

When an emulated indicator is on, it appears in reverse image on the 
options screen. 

Ready Indicator 

The Ready indicator is turned on by selecting the Start option. 
Whenever the indicator is on, the printer Emulation Program is ready 
to send data to the printer. 

The Ready indicator is turned off by an end of forms condition, a 
Reset command from the host, a printer error (printer in a not ready 
state), a graphics check error, or an attention message from the 
host. You can turn it off by selecting the Stop/Reset or the Suspend 
option. 

Attention Indicator 

The Attention indicator turns on when your attention is required by 
the host. The indicator can be turned on by a personal computer 
printer condition that turns the Ready indicator off and turns the 
Forms or Graphics Check indicator on. 

Selecting the Stop/Reset option turns this indicator off. 

Forms Indicator 

The Forms (out of paper) and Attention indicators notify you that the 
printer is out of paper. Select the Stop/Reset option to turn the 
Forms and Attention indicator off. After a new supply of paper is 
loaded and the printer is made ready, select the Start option to 
resume printing. 

Graphics Check Indicator 

The Graphics Check indicator is on when an unprintable character is 
detected in the print buffer and the Set Graphics Error Action 
command stop option was set previously. (The line containing the 
unprintable character is printed with a substitute character in place of 
the unprintable character.) 
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The Ready indicator is turned off and the Attention indicator is turned 
on when the Graphics Check indicator is turned on. 

Selecting the Stop/Reset option turns the Graphics Check indicator 
off. 

Change Font Indicator 

The Change Font indicator is turned on when a request is received 
to change the font. The 2-digit code that appears in the output data 
field describes the requested font. See Appendix A, Error Codes 
and Messages, for the description of the codes. 

Note: This indicator is not used with a printer that can change fonts 
without user intervention (specified when you configure advanced 
printer options). 

System Available Indicator 

The System Available indicator is turned on whenever a printer 
command, other than a Reset command, is received by the printer 
Emulation Program. 

This indicator is turned off when communication with the host stops. 
Printer Session Number (Sn) 

The printer session number appears on line 25 as Sn (where n is the 
number of the session). 

Station Address Number (Ax) 

The printer workstation address is displayed on the emulated control 
panel. Pressing the WS Addr key sequence (Alt+Ctrl) again 
removes the address from the emulated control panel. 



User-Defined Printer 

The Emulation Program allows you to make a non-supported printer 
class known to the program. To do this, you create a printer function 
table that the Emulation Program uses to convert controls into the 
escape sequences, controls, and graphics understood by the printer. 

For information about creating printer function tables, see 
Chapter 10, "Using the Printer Function Table Setup Program." 
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Chapter 9. Emulating an IBM 5256 Printer 



The personal computer printers listed in Figure 9-1 are capable of 
emulating the 5256 printer when used with a supplied PFT. If the 
supplied PFT for your printer is listed as Internal, select your printer 
from the Attached Printer List screen during session configuration. 



Figure 9-1 (Page 1 of 2). PC Printers That Can Emulate 5256 
Printers 


Personal Computer Printer 


Supplied PFT 


IBM Personal Printer Series IBM 2380, IBM 
2380 Plus, IBM 2381, IBM 2381 Plus, IBM 
2390, IBM 2390 Plus, IBM 2391, and IBM 
2391 Plus 


IBM2390.PFT 


IBM 3812 Pageprinter 


IBM3812.PFT 


IBM 4019 and 4029 Laser Printers 


IBM4019.PFT 
(for PPDS) 
HPLASER2.PFT 
(for PCL)1 


IBM 4039 Laser Printer 


PCL5.PFT 2 


IBM 4037 5E Printer 


IBM4019.PFT 


IBM 4070 IJ Printer 


IBM4208.PFT 


IBM 4072 ExecJet Printer 


IBM4072.PFT 


IBM 4076 ExecJet II Printer 


IBM4207.PFT 
(for PPDS) 
HPLASER2.PFT 
(for PCL)1 


IBM 4201 Proprinter 


Internal 


IBM 4202 Proprinter XL 


IBM4202.PFT 


IBM 4207 Proprinter X24 


IBM4208.PFT 


IBM 4208 Proprinter XL24 


IBM4208.PFT 



1 The HPLASER2.PFT requires the Roman 8 symbol set to be in your printer. 

2 The PCL5.PFT requires the PC-850 symbol set to be in your printer. 
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Figure 9-1 (Page 2 of 2). PC Printers That Can Emulate 5256 
Printers 


Personal Computer Printer 


Supplied PFT 


IBM 4212 Proprinter 24P 


IBM4212.PFT 


IBM 4226 Printer 


IBM4226.PFT 


IBM 5152 Matrix Printer (Model 001) 


Internal 


IBM 5152 Graphics Printer (Model 002) 


Internal 


IBM 5182 Color Printer 


Internal 


IBM 5201 Quietwriter 


Internal 


IBM 5202 Quietwriter III 


IBM5202.PFT 


IBM 5204 Quickwriter 


IBM5204.PFT 


IBM 5216 Wheelprinter 


Internal 


HP LaserJet Printer Series II and III 


HPLASER2.PFT 3 


HP LaserJet 4 


PCL5.PFT 4 


User-defined printer 


Internal 



Introducing 5256 Emulation 

One of the above printers can be used to emulate the IBM 5256 
Matrix Printer when the second session of the Emulation Program is 
configured for 5256 printer emulation. Any printer capable of 
emulating a 5256 may be attached. However, functions not available 
on the 5256 are not supported, even though the attached printer may 
support them. 

For example, a 3812 emulating the 5256 is different from a 3812 
directly attached to the host. This means that 3812 functions, such 
as bold printing and the Set Text Orientation command, are not 
supported. 



3 The HPLASER2.PFT requires the Roman 8 symbol set to be in your printer. 

4 The PCL5.PFT requires the PC-850 symbol set to be in your printer. 
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Notes: 



1 . The keyboard customization file that is in effect for the display 
emulation session is also in effect for printer emulation. 

2. Printer emulation continues when in personal computer mode 
unless the printer session is suspended before entering that 
mode. 

3. Transparent mode or Buffer Print is not supported with the 
Emulation Program. 

The IBM 5256 Printer Emulation uses a session profile. (See 
"Configuring for Emulation" on page 3-25 for further information.) 

In printer emulation mode, the personal computer display screen 
emulates the operator panel on an IBM 5256 printer. 



Serial Printer Limitations 

If you will be using a serial printer, you should be aware of the 
following limitations: 

• No other communications adapters (SDLC, BSCA, and so on) 
may be used concurrently in the personal computer. 

• Only one Asynchronous Communications Adapter may be used 
in the personal computer. 

• The printer emulation code cannot detect the difference between 
"Printer Off Line" or "Paper End" conditions in the serial printer. 

If either condition occurs, printer emulation shows Printer Off 
Line. The printer Emulation Program tries to send data to the 
printer until all the data is successfully transmitted. 

• Baud rate is limited to a maximum of 4800 when running on the 
IBM Personal Computer, the IBM Portable Personal Computer, 
or the IBM Personal Computer XT. It is your responsibility to 
make sure this rate is not exceeded. 

If, during initialization, the printer Emulation Program detects that 
this limitation is exceeded, 4800 baud is used instead of the 
selected baud rate and unexpected results might occur. 
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Setting Up the Printer 



The Emulation Program sets up the attached personal computer 
printer according to options chosen during configuration. LPI, CPI, 
paper width, form feed, and font changes without user intervention 
can be specified. (See "Advanced Printer Options" on page 11-8 for 
more information.) 

Each defined printer session requires a separate printer. 



5256 Printer Emulation Display 

The options and indicators are shown in Figure 9-2. 



5256 PRINTER EMULATION - OPERATOR SCREEN 



OPTION MENU: 



INDICATORS: 



1 Start 

2 Stop/Reset 

3 Suspend 

4 Cancel 

5 Line Feed 

6 Form Feed 

7 Select Printer Parameters 



Attention 



Graphic Check 



Ready 



Forms 



Data Cleared 



SELECT OPTION 



System Available 



S2 



Figure 9-2. IBM 5256 Matrix Printer Options 
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Using the Emulated Printer Options 

The 5256 Printer Emulation — Operator Screen emulates the operator 
panel on the printer and uses the following options: 

• Start 

• Stop/Reset 

• Suspend 

• Cancel 

• Line Feed 

• Form Feed 

• Select Printer Parameters 

To select an option, type the associated number and then 
press Enter. 

Start Option 

Selecting the Start option while the Ready indicator is on carries out 
no function because its intended function is to make the printer ready 
to print. 



If the Ready indicator is off when the Start option is selected, the 
result depends on the condition of the printer emulation routine, as 
shown in Figure 9-3. 



Figure 9-3 (Page 1 of 2). Start Option 


Condition 


Result 


Emulation Program is loaded and 
no error conditions exist. 


Turns the Ready indicator on. 


Printer Emulation Program was 
halted by the Stop/Reset option, 
or the Stop/Reset option was 
used to reset an error condition. 


Turns the Ready indicator on and 
continues printing. 
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Figure 9-3 (Page 2 of 2). Start Option 


Condition 


Result 


Printer Emulation Program was 
halted by the Suspend option. 


Turns the Ready indicator on, 
returns personal computer printer 
control to 5256 printer emulation, 
restores the printer to the state it 
was in at the time the Suspend 
option was selected, and 
continues printing. The current 
print line becomes the logical top 
of page. 



Stop/Reset Option 

Selecting the Stop/Reset option while the Ready indicator is on 
causes the Ready indicator to be turned off. The printer continues 
printing until its buffer is empty. The Emulation Program does not 
process any further commands from the host until the Start option is 
selected. 

If this option is selected when the Ready indicator is off, it functions 
as a Reset key. 

This option is intended to temporarily stop printing and allow 
adjustments to the printer, such as changing paper. 

Suspend Option 

Selecting the Suspend option while the Ready indicator is on causes 
the Ready indicator to be turned off and all information in the 
printer's print buffer to be printed. The Emulation Program does not 
process any further data or commands from the host. 

In addition: 

• The current status of the emulated 5256 printer is saved. 

• The forms advance to the first print line of a new page. 

• The printer enters its initialized state (Ready and Online). 

• All operator panel options, except Start, are disabled. 
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This option allows you to free the printer from the host and make it 
available to the personal computer. Use the hot key sequence to go 
to personal computer mode. 

After the hot key sequence, you can move the forms to any position 
and use the printer for any personal computer printing. When 
finished, you should position the forms to the first print line of a new 
page. 

The Suspend option is accepted regardless of the state of the Ready 
indicator. 

To return the printer to host control, select the Start option and press 
Enter. 

Note: This option is necessary only if the application program uses 
the same printer device name (LPT1 , LPT2, and so on) as the 
Emulation Program (selected using the configuration program). If the 
application program is using a different printer, then the Emulation 
Program can print at the same time as the application program 
without being suspended. 

Cancel Option 

Selecting the Cancel option causes the host to be notified of the 
cancel request. 

Line Feed Option 

Selecting the Line Feed option when the Ready indicator is off 
advances the forms to the next print line. 

The Line Feed option is ignored when the Ready indicator is on. 

Form Feed Option 

Selecting the Form Feed option when the Ready indicator is off 
advances the forms to the first print line of the next form. 

The Form Feed option is ignored when the Ready indicator is on. 

Note: The operation of this option depends on previous commands 
to the printer. That is, the form length assigned by the host program 
must be the same as the actual length of the form. 
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Printer Parameters 



The printer parameters appear as shown in Figure 9-4. If the host 
sends an LPI or CPI command to the printer, it overrides the 
parameters you selected. 



5256 PRINTER EMULATION - PRINTER PARAMETERS 



SELECT LINES PER INCH (LPI) 

1 6 LPI [ACTIVE] 

2 8 LPI 



SELECT CHARACTERS PER INCH (CPI) 

3 Normal (10 CPI) 

4 Compressed (15 CPI) [ACTIVE] 



5 Return to Operator Panel 
SELECT OPTION 

OPERATOR MESSAGE FIELD S2 



Figure 9-4. Emulated IBM 5256 Matrix Printer Parameters 



Lines Per Inch (LPI) 

6 LPI Option 

Selecting 6 LPI (lines per inch) causes the printer to print six lines of 
text per inch of page length. 

8 LPI Option 

Selecting 8 LPI (lines per inch) causes the printer to print eight lines 
of text per inch of page length. 

Note: The current line spacing option is shown with the word 
ACTIVE appearing next to the option selected. 
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Characters Per Inch (CPI) 



10 CPI Option 

Selecting 10 CPI (characters per inch) causes the printer to print 10 
characters per inch. If the attached printer has an 8-inch paper width 
and more than 80 characters are formatted for a line, the extra 
characters are printed on the following line. 

15 CPI Option 

Selecting 15 CPI causes the printer to print 15 characters per inch 
(compressed print). When the attached printer has an 8-inch paper 
width, this option allows 132 characters to be printed on a line. 

Note: The current character spacing option is shown with the word 
ACTIVE appearing next to the options selected. 

Status Indicators 

The emulated operator panel emulates the following status 
indicators: 

• Ready 

• Attention 

• Forms 

• Graphics Check 

• Data Cleared 

• System Available 

When an emulated indicator is on, it appears in reverse image on the 
options screen. 

Ready Indicator 

The Ready indicator is turned on by selecting the Start option. 
Whenever the indicator is on, the printer Emulation Program is ready 
to send data to the printer. 

The Ready indicator is turned off by the following: 

• End of forms condition 

• Reset command from the host 

• Printer error (printer in a not ready state) 

• Graphics check error 

• Attention message from the host. 
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You can turn it off by selecting the Stop/Reset or the Suspend 
option. 

Attention Indicator 

The Attention indicator turns on when your attention is required by 
the host. The indicator can be turned on by a personal computer 
printer condition that turns the Ready indicator off and turns the 
Forms or Graphics Check indicator on. 

Selecting the Stop/Reset option turns this indicator off. 

Forms Indicator 

The Forms (out of paper) and Attention indicators notify you that the 
printer is out of paper. Select the Stop/Reset option to turn the 
Forms and Attention indicator off. After a new supply of paper is 
loaded and the printer is made ready, select the Start option to 
resume printing. 

Graphics Check Indicator 

The Graphics Check indicator is on when an unprintable character is 
detected in the print buffer and the Set Graphics Error Action 
command stop option was set previously. (The line containing the 
unprintable character is printed with a substitute character in place of 
the unprintable character.) 

The Ready indicator is turned off and the Attention indicator is turned 
on when the Graphics Check indicator is turned on. 

Selecting the Stop/Reset option turns the Graphics Check indicator 
off. 

Data Cleared Indicator 

The Data Cleared indicator is turned on when a Clear command is 
received from the host to tell you that a problem occurred and all 
print buffers were cleared of data. See the appropriate host 
instructions for recovery procedures. After the cause of the problem 
is corrected: 

1 . Select the Stop/Reset option to turn off the Data Cleared 
indicator. 

2. Align the forms to print the first line. 
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3. Make the printer ready. 

4. Select the Start option to make the Emulation Program ready. 
System Available Indicator 

The System Available indicator is turned on whenever a printer 
command, other than a Reset command, is received by the printer 
Emulation Program. 

This indicator is turned off when communication with the host stops. 
Printer Session Number (Sn) 

The printer session number appears on line 25 as Sn (where n is the 
number of the session). 

Station Address Number (Ax) 

The printer workstation address is displayed on the emulated control 
panel. Pressing the WS Addr key sequence (Alt+Ctrl) again 
removes the address from the emulated control panel. 



User-Defined Printer 

The Emulation Program allows you to make a non-supported printer 
class known to the program. To do this, create a printer function 
table that the Emulation Program uses to convert controls into the 
escape sequences, controls, and graphics understood by the printer. 

For information about creating printer function tables, see 
Chapter 10, "Using the Printer Function Table Setup Program." 
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Chapter 10. Using the Printer Function Table 
Setup Program 

The Printer Function Table (PFT) describes the functional 
characteristics of a personal computer printer to the Emulation 
Program. You create and edit this table with the PFT setup program. 
If your printer is not supported and cannot function as a supported 
printer, you need a PFT to use the printer with the Emulation 
Program. 

PFTWS.PRN is a worksheet for the program. You can print this file 
and use it when preparing for the program. 

Note: The Emulation Program may not require or use all the 
functions provided by the printer. Also, the Emulation Program does 
not use all the functions provided by the PFT setup program itself. 
Only those functions described in this chapter are supported by the 
Emulation Program. 



Creating a Printer Function Table 

Use this procedure to create a PFT: 

1 . If you have a serial printer, use the DOS MODE command to 
direct the printer output to the serial port before you run the PFT 
setup program. At the DOS prompt type the following 
commands, pressing Enter at the end of each line. 

MODE C0Ml:1200,n,8,l,p 
MODE LPT1:=C0M1 

Note: The baud rate and other parameters on the COM1 line 
vary depending on the printer. See the printer operator's guide 
for the correct information to enter on the COM1 line. 

2. To start the program, type PFTSETUP and press Enter. 

3. Select the option to create a table. 

4. A screen of information appears. Read the information, then 
press Enter to continue. 
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5. Enter a PFT file name. Use the second option if you need to 
make changes to a PFT you have created or a PFT provided by 
the Emulation Program. 

6. The Revise Printer Function Table menu appears. Choose the 
option you want to define. 

7. The program prompts you for all necessary information about 
printer functions. See "Defining Printer Functions" on page 10-5 
for a description of each printer function. See "Entering Control 
Sequences" for information on entering control sequences in the 
PFT. 

Refer to the printer operator's guide for the correct terminology 
for each function. Study the functions and the concepts 
described to determine the appropriate use or need for each PFT 
item. 

8. After you finish defining functions, run the Function Selection 
Tests. (See "Function Selection Tests" on page 10-12.) 

9. Update the session profile to use the PFT. (For more 
information, see step 8 on page 3-34.) 



Entering Control Sequences 

A control sequence is a sequence of hex values that instructs the 
printer to perform a specific function or print a particular output. Use 
these rules when entering control sequences: 

• Use two hex digits for each byte to be sent to the printer. 

• Leave one space between each pair of hex digits. 

• Use either upper or lowercase letters. 

• Enter a maximum of 41 characters, including spaces, in the first 
field of a control sequence (14 bytes of hex values). 

• Enter a maximum of 59 characters, including spaces, in the 
continuation field (20 bytes of hex values). 

• Use a variable placeholder (n or N) separated by a space if a 
printing function can be changed at print time by specifying a 
variable to the printer. 
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• Multiple controls can be used in one control sequence. 
However, you can only use one variable n per sequence. 

• Do not enter a variable n as the first byte of a control sequence. 

For example, if the printer operator's guide specifies Esc+E for a 
particular function, type 1B 45 (1B is the ASCII hex value for Esc, 
and 45 is the value for E). 

Note: If a control sequence sets a printer mode that affects the 
operation of other control sequences, be sure to reset this mode in 
the affected sequences. 

Variable n 

Each printer interprets the value for the variable n differently. The 
interpretation is based on this algorithm: 

(value sent to printer +/- offset) * x/y = n 

Maximum Value of the Variable n determines the type of encoding 
and number of bytes to send to the printer (the value, or the variable 
n, in the algorithm). See the printer operator's guide for the 
maximum decimal value allowed for each variable n. 

For example, if the printer operator's guide defines a control in which 
a value of zero is equal to a parameter value of hex 40 (decimal 64) 
and a maximum number of units supported by the control is hex OF 
(decimal 15), then the maximum value of n is 79. Or, if the printer 
operator's guide defines a control sequence, such as Esc+US+/7, 
where n-1 is the value used by the printer and the value of n cannot 
exceed hex 7E (decimal 126), then the maximum value of n is 126. 

Offset Added/Subtracted by the Printer to the Value of n provides 
a way to enter a decimal number that the printer adds or subtracts to 
the variable n when it receives the control sequence. For some 
printers, the value of n must be adjusted before being sent to the 
printer, because the printer performs an adjustment on the value. 
For example, if the printer operator's guide states n+1 is the value 
used by the printer, then the offset is 1 and is added to the variable. 
Or, if the printer operator's guide specifies a chart where a value of 
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zero equates to a parameter of hex 40 (decimal 64), then the offset 
is 64, which is subtracted from the variable. 

Control Increments (x/y inches) represent a scaling factor used to 
convert the value of the variable n to inches. For some printers, the 
value of n must be defined in fractions of an inch. For example, if 
x/y=1/72, the variable represents units of 1/72 inch. 

When x/y=MA, the variable represents units of 1 inch, and the 
algorithm is simplified to this: 

(value sent to the printer +/- offset) = n 

If the printer operator's guide defines n (or n times a fraction) as the 
value used by the printer (for example, n/72), the offset is zero. The 
algorithm simplifies to this: 

(value sent to the printer * x/y) = n 

Determining the Format of the Variable n 

The PFT setup program requires that you run the test to determine 
the format of the variable n. 

Each variable n must be in a specific format for the printer. The PFT 
setup program helps you specify the format. When you press Enter 
in a menu that was just modified and that defines a variable n, the 
PFT setup program tests the variable n on the printer. You then 
examine printed output and respond to questions on the screen. 
These responses determine the value of the variable n. If 
necessary, you can redefine the control sequence and press Enter 
again to determine the type of variable. If none of the tests provides 
the correct result, the Emulation Program cannot use the function on 
your printer. 
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Defining Printer Functions 

The Revise Printer Function Table menu lists the control sequences 
you can define for printer functions: 

• Initialization and reset 

• Vertical and horizontal spacing 

• Highlighting 

• Paper and page options 

• Type styles and character sets 

• User-defined controls 

The Emulation Program does not support user-defined controls. 

Initialization and Reset 

The PFT setup program allows you to define Start of Document 
Initialization and End of Document Reset. 

Start of Document Initialization 

Note: The PFT setup program sends the control sequence for Start 
of Document Initialization to the printer before every test. 

The Emulation Program uses this control when a printer session is 
first started or when a printer session is resumed after being 
suspended. You may define a control in the Start of Document 
control sequence or set a printer switch to set each of the following 
conditions: 

Vertical Units 

Line Spacing 
Pitch 

Carriage Return 



Line Feed 
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Units defined for the Variable Line Spacing 
control. 

6 lines per inch. 
10 pitch. 

With no line feed. If a carriage return cannot be 
achieved without a line feed, zero index carriage 
return (ZICR) is not supported. Also, line 
spacing may always be incorrect if the sequence 
carriage return line feed causes an extra line 
feed. 

Perform a line feed with no carriage return. 



Turn Off 



Superscript, subscript, underline, overstrike, bold, 
Proportional Space Mode (PSM), justification. 



Character Set 



Default of the printer. Set to PC character set 2 
if the printer supports it. 



Printing Mode 



Bidirectional or unidirectional mode, depending 
on the printer. 



Color 



Black. 



Line Length 
Page Length 



Maximum supported by the printer. 



11 inches. 



Do not define a control sequence that can affect a preceding print 
job. 

End of Document Reset 

The Emulation Program uses the control sequence for End of 
Document Reset when a printer session is suspended. You should 
define a control (where applicable) in this control sequence to 
achieve the following conditions: 

• Vertical units 

• Line spacing (in default vertical units) 

• Carriage return status 

• Line feed status 

• Page length 

• Left margin 

• Printer font (pitch and type style) 

• Printer character set 

• Portrait and landscape status 

• Color 

• Printing mode 

Vertical and Horizontal Spacing 

The Vertical and Horizontal Spacing option allows you to define 
these functions: 

• Vertical line spacing 

• Horizontal character spacing 

• Horizontal relative movement 
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Vertical Line Spacing 

Vertical line spacing is a measure of the distance between printed 
lines. You can define vertical line spacing by lines per inch (LPI) or 
variable line spacing (VLS). 

The Emulation Program uses the controls for 6 or 8 LPI. Otherwise, 
the VLS control is used. VLS must be defined to support 4, 12, and 
24 LPI. If your printer has specific controls for 6 and 8 LPI, you 
should define all three sequences. 

Lines per Inch: The most common vertical line spacing is 6 or 
8 LPI. The Emulation Program supports 4, 6, 8, 12, and 24 LPI. 
You can define a control sequence to set 6 LPI and one to set 
8 LPI. 

Variable Line Spacing: A VLS control sets the vertical line spacing 
to a variable value. Some printer manuals refer to VLS as Line Feed 
Pitch. Check the printer operator's guide, especially if a variable 
increment is allowed, for the function that controls vertical motion. 

If you define a VLS, try multiples of 1/48 first. Otherwise, use the 
smallest increment of vertical spacing supported by the printer. 
Common values are 1/48, 1/72, and 1/96. 

Indexing Functions: The Emulation Program uses indexing to 
support superscripts and subscripts. 

The Begin and End Superscript and Subscript controls function on all 
feed devices. On some printers, these controls move the print 
position up or down 1/2 line spaces. Other printers create 
superscripts and subscripts by compressing the height of the 
characters. If your printer can only print superscripts and subscripts 
in one pitch, do not define these controls. 

The Emulation Program does not support 1/2 Index Up (reverse), 1/2 
Index Down (forward), or Reverse Index. These controls move the 
print position up or down 1/2 the active line spacing. 
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Horizontal Character Spacing 

Horizontal character spacing refers to the number of characters in a 
horizontal inch of printing. You can set up Horizontal Character 
Spacing by pitch value or Horizontal Motion Index (HMI). The value 
of a pitch is determined by the width of the characters and how far 
apart they are spaced on the printed page. For example, 10 pitch 
refers to 10 characters in a horizontal inch. The Emulation Program 
supports 10, 12, 15, and 17 pitches. It does not support 5 and 8.55 
pitches. Proportional Space Mode (PSM) is supported with the HMI 
control. 

Some printers use the HMI control to support pitch. HMI causes the 
print element to move the appropriate increment to position the 
characters. If you define an HMI, try multiples of 1/60 inch. If you 
cannot use these multiples, use the smallest spacing supported by 
the printer. Common values are 1/60 and 1/120 inch. 

For each pitch in a print job, the Emulation Program first checks for a 
defined pitch control sequence. If it is defined, the active pitch is set 
accordingly. Otherwise, the Emulation Program sets the defined 
pitch control nearest to the one received. If no pitch control 
sequence is defined, the Emulation Program prompts you to change 
the physical font at the attached printer. 

HMI is also used to justify text and to support proportionally spaced 
fonts. 

Horizontal Relative Movement 

The Horizontal Relative Movement (HRM) controls move the print 
position backward or forward relative to the current print position. 
Some printer manuals refer to HRM as Horizontal Cursor Positioning. 
Find the function in the printer operator's guide that moves the 
horizontal position of the printer relative to the current position. 

If possible, define control sequences for forward and backward 
relative movement. Try multiples of 1/60 inch first. Otherwise, use 
the smallest increment of horizontal spacing supported by the printer. 
Common values are 1/120 and 1/240 inch. 
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The Forward Relative Movement control can be used to justify text. 
The Backward Relative Movement control can be used to unit 
backspace. 

Proportional Space Mode and Justification 

You must define HMI or HRM controls to space words evenly on a 
justified line. You must define HMI to space text proportionally. 
Otherwise, Proportional Space Mode (PSM) is not supported. 

For 5219 emulation, you must define either HMI or forward HRM. If 
you want to use unit backspacing with 5219 emulation, you must 
define backward HRM. 

Highlighting 

The Emulation Program supports Begin Quality Print and End Quality 
Print. 

The Emulation Program supports Begin Emphasis and End 
Emphasis controls. However, the host currently uses backspace and 
overstrike to print bold in 5219 emulation. The Emulation Program 
does not support Begin Underline and End Underline. Multiple 
passes on the print line are used to underline text. 

Paper and Page Options 

The paper sources defined during configuration can be supported by 
defining paper handling and page length controls in the PFT setup 
program. The Emulation Program does not support the Paper 
Positioning, Set Left Margin, Carriage Return and Line Feed, Multiple 
Copies, or Landscape Paper Handling controls. If your printer does 
not have advanced paper handling capabilities, the Emulation 
Program provides default values for the controls that are not 
specifically defined. 

Paper Handling 

To control the paper source requested by a print job, the Emulation 
Program uses the control sequences for Bottom, Top, and Envelope 
Tray Select and Feed for paper feed; Manual Feed Select; and the 
Automatic Cut Sheet option for ejecting sheets without paper feed. 
The Emulation Program does not support the controls for Continuous 
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Feed Select, Ignore Paper End Sensor, Enable Paper End Sensor, 
Manual Cut Sheet, and Collate. 

Some printers require two controls for the paper (or envelope) feed 
function: one for paper tray selection and one for loading paper from 
that tray. In this case, define both controls in the control sequence. 

If the printer has an automatic sheet-feed device, define all five 
paper feed items if possible. If the printer supports a paper feed, 
such as single-drawer automatic sheet feed, but does not define a 
control sequence to select or feed paper from that paper feed, define 
a null (hex 00) for that paper feed. 

The select and feed controls in the Paper Handling menu can be 
defined for the bottom, top, and envelope tray. This control causes a 
sheet of cut paper (or envelope) to be fed into the printer from the 
specified tray. If the print job indicates that one of these trays is to 
be used and no control is defined, the Emulation Program uses the 
manual feed select control. 

The manual feed select control allows the automatic sheet-feed 
device to accept a manually inserted sheet of paper through the 
manual insertion gate. The printer must stop printing to accept the 
manually fed sheet. 

The Emulation Program assumes that continuous forms feed is 
available. 

If the eject sheet without paper feed (automatic cut sheet) control is 
defined, the Emulation Program assumes the paper feed controls 
eject the current page and feed the next page. 

The Emulation Program assumes the manual feed select control 
ejects the current page and stops the printer for the next manually 
inserted page. 

Run the print test for continuous feed select on a continuous forms 
feed. Run the print tests for bottom, top, and envelope trays on an 
automatic feed. Run the print test for manual paper feed insertion on 
a manual feed or automatic feed with a manual insertion gate. 
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Page Length 

The Emulation Program uses the page length controls to set the 
length of the page. You must specify the page length controls with 
one of the options (inches or lines). 

Type Styles and Character Sets 

Type style defines the appearance (font) and pitch of characters. 
For example, Gothic characters look different from characters printed 
in a commonly used type style, such as Prestige Elite. You can 
define default, individual, and group type styles. 

Character sets are defined groups of graphic characters. For 
example, a character set can include a through z, A through Z, and 
other print characters. 

For each individual and group type style definition, you can select a 
PC character set. When you print, all type styles not defined use the 
default type style definition. The default definition selects a PC 
character set. 

If the printer has removable print elements, such as a printwheel, you 
can define a character set to match those on a print element, then 
associate the character set with a type style number. 

You can also define a character set to include characters that can be 
constructed from those on the print element. For example, if the 
print element has a tilde, you can define the n tilde character as n 
backspace tilde. 

The Emulation Program does not support Slot Selection Definition. 
Default Type Style 

Type style definitions allow you to specify the controls that select the 
type styles and character sets supported by your printer. Type styles 
are defined with initial and ending control sequences for PC 
character sets 2 through 9. The initial control sequence selects the 
print element for a type style and a character set. The ending 
control sequence is optional. The Emulation Program outputs this 
sequence before selecting a new type style or character set. 
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Individual Type Style 

An individual type style definition can be defined to select a type 
style and associated character sets. Use an individual definition to 
define a type style that can only be selected using unique control 
sequences for each print element. 

Group Type Styles 

You can define a Group Type Style to select a group of type styles 
and associated character sets on the printer. Each group type style 
definition is assigned a group type style identifier. There are 26 
identifiers (A through Z). Use a group type style definition to define a 
group of type styles that are selected through common control 
sequences. For example, you can define a group type style 
definition for a print element that supports the PC character set and 
Courier type style in 10, 12, and 15 pitch. The corresponding type 
style numbers you would type in the definition would be 11, 85, and 
223. 

Character Set Redefinition 

The Emulation Program supports PC character sets 2 through 9. 



Function Selection Tests 

After you create or revise a PFT, run the function selection tests to 
verify the print functions you defined in the table: 

• Superscript and subscript 

• Form feed 

• Pitches 

• Backspace 

You do not need to run the tests for the functions not supported by 
the Emulation Program (Underline, Emphasis, and Cursor Draw). 

Use this procedure to run the tests: 

1. Choose the Function Selection Test option from the main menu. 

2. Select a test and prepare the printer as directed by the test. 

3. The test will print samples. Answer the questions on the screen 
according to the output from the printer. When more than one 
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example is printed, choose the first one that provides the 
appearance you want. 

4. If none of the printed results appear as you want, choose the 
example that is closest. Or, you can redefine the control 
sequence for the function. 

5. If you decide to redefine any controls, run the tests again. 

Note: If a control that is not defined is used in a test, the test is 
printed without that control. 

Run the tests to ensure that you have defined the print functions 
correctly. If you do not, the PFT setup program prompts you to run 
them before you exit the program. 
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Chapter 11. Advanced Configuration 



This chapter explains the following advanced configuration options: 

• Display session options 

• Printer session options 

For detailed installation and configuration instructions, see 
Chapter 3, "Detailed Installation and Configuration." For quick start 
installation and configuration instructions, see Chapter 1 , "Quick 
Start Instructions for the Emulation Program." 



Advanced Display Options 

The following options are available for each session you have 
configured as a display: 

• Select additional display options 

- Bypass pre-signon screen 

- Immediate hot key option 

- Enable/disable keystroke buffering 

- Set print screen character set 

- Enable/disable autodim feature 

• Select emulated display device as either 3196 monochrome 
display emulation or 3197 color display emulation 

• Customize host to PC display code page mapping 

• Customize screen colors and attributes 

• Select monitor types for color graphics adapter 

• Select workstation address list 

• Set column separator attribute 

The options for customizing the display appear when you choose 
Select Display Emulation Options from the Advanced Options menu. 
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More Display Options 

Additional options appear when you choose 'Select additional display 
options' from the Advanced Display Options menu. 

Bypass Pre-Signon Screen 

The pre-signon screen displays the sessions as they become active 
when you load the Emulation Program. This option allows you to 
bypass the pre-signon screen when you load the Emulation Program. 
Otherwise, when the signon screen appears, you need to press any 
key to continue. 

Immediate Hot Key Option 

This option instructs the Emulation Program to switch to the DOS 
session immediately after you load the program, instead of switching 
to the first active session. 

You can use this option with the Bypass Pre-Signon screen option to 
load the Emulation Program from a batch file, then return 
automatically to the batch file processing. 

Buffer Keystrokes 

This option allows you to "type ahead," that is, continue typing while 
the host Input Inhibit indicator is on. If keystroke buffering is 
configured for a session and the Input Inhibited indicator is on, up to 
32 keystrokes are stored and then sent to the host when the Input 

I K ! KJ+*-»/-J i ^ /-J i /->*-»+■/-> v I r-» /-xf-f If vy\ r\ vr\ tknn OO \s r\\ tr* <-» vr\ v-\ <t-> /-\ /-J <-» r-» nln rivi 

1 1 1 1 1 1 ui ic7v_j ii ivjiv^ciiwi 10 w ii . ii ii ivj i c; 11 1 ci 1 1 \jc- r\^yo cut? \j i C700^u , cu i cucu 1 1 1 

is sounded for each key and the keystroke is discarded. As the 
buffer space is freed, additional keystrokes sent to the host are 
buffered. 

Print Screen Character Set 

This option allows you to specify the number of characters used 
when you print the screen. For example, the IBM Graphics Printer 
and Proprinter prints 255 characters; the IBM Matrix Printer prints 
127. If you use a printer that can print 255 characters, you need to 
specify the 255 character set. 
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Autodim Feature 

Use this option to dim the display after the number of minutes of no 
activity that you specify. To prolong the life of the display, use this 
option when you leave the screen unattended and do not want to 
stop sessions. 

Customize Host to PC Display Code Page Mapping 

The host EBCDIC-to-PC ASCII table provides the translation of 
EBCDIC values to ASCII. (See your Technical Reference manual for 
the EBCDIC and ASCII code page tables.) 

Use this option to modify the translation of host EBCDIC characters 
to personal computer ASCII characters. Changing the tables affects 
only how the characters are displayed, not what is sent from the 
host. 

An example of the use of this option is to assign the ASCII 
line-drawing characters to unassigned EBCDIC codes to display lines 
and box corners in a display session. 

The session profile maintains two of these tables, one for the display 
and one for the printer. Modifications to the display table do not 
affect the printer table. 

This table is based on the code page chosen in the Select Host to 
PC Display Code Page Mapping menu. The default is code page 
037 to code page 437. If you have DOS set to code page 850, you 
may notice some characters do not appear as you expect them. For 
example, the cent sign (0), ASCII code point 9B in the 437 code 
page, is code point BD in 850 code page. 

The index to the table is the host EBCDIC code point and the value 
at that location is the personal computer ASCII code point. 
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For example, the capital A in EBCDIC code page 037 is at code 
point x'C1 1 . The capital A in ASCII code page 437 is at code point 
x'41 '. Find the 'CO' line in Figure 11-1 and look at the value in the 
'1 ' column. As shown in Figure 11-1, code point x'41 1 (which 
represents the capital A) is at location x'C1 '. 
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Figure 11-1. Example EBCDIC Code Page 037 to ASCII Code 
Page 437 Table 

Note: Any changes you make to the mapping table are stored in 
the session profile (DP5250.DAT). If you type CONFIG without 
specifying your existing profile and then save the new profile 
information, your changes will be lost. 

Screen Colors and Attributes 

This option allows you to change the display attributes: 

• Blink 

• Column separator 

• High intensity 

• Normal 
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• Reverse 

• Underscore 

• Screen color 



The configuration program first prompts you to specify whether the 
display is color or monochrome. Then it displays the Customize 
Color Display Attributes screen, which is shown in Figure 11-2. This 
screen contains the hex value for each attribute. You can change 
the appearance of an attribute by changing its hex value. 
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Press (Enter) when complete to save updates. 
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Figure 11-2. Customize Color Display Attributes Screen 

The two hex values in the brackets make up the PC color attribute 
codes. Listed to the right of each PC attribute code is the host 
attribute code, which is displayed using the PC attribute code that is 
in the brackets. A description of how the host defines each host 
attribute is listed to the right of the host attribute code. (For a 
description of the host attributes, see the Technical Reference 
manual.) You may modify the PC attribute values to whatever you 
prefer. Press Enter to save your updates. 
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The first value in the PC attribute code bracket is the background 
color, and the second value is the foreground color. The values are: 



0 


= Black 


8 


= Gray 


1 


= Blue 


9 


= Light blue 


2 


= Green 


A 


= Light green 


3 


= Cyan 


B 


= Light cyan 


4 


= Red 


C 


= Light red 


5 


= Magenta 


D 


= Light magenta 


6 


= Brown 


E 


= Yellow 


7 


= White 


F 


= High-intensity white 



Note: If you enter a background value from 8 to F, the field will 
blink. 

Host attributes 27, 2F, 37 and 3F are reserved by the host 
and cannot be modified. 

The host attribute codes hex 20 and 21 determine the appearance of 
the display session status line indicators and the printer operator 
panel. Hex 20 determines their appearance when they are OFF, and 
hex 21 when they are ON. You cannot assign hex 20 and 21 the 
same attribute value. 

Monitor Type 

This option allows you to specify the type of monitor connected to 
your color graphics adapter card in your personal computer. 

Workstation Address List 

In basic configuration, you specified a unique address for each 
session. You can also enter a list of addresses (that is, an address 
search list) for a session. This allows, for example, four users to 
share three addresses. The host allows up to seven addresses on a 
local workstation line. You can include up to six addresses in a list. 
The Emulation Program listens to the line and searches for the first 
address that is not being used by any other workstation. The host 
first tries the station address specified as "Primary Address," then it 
tries the remaining addresses in the list. If one of the addresses is 
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not currently being used by another workstation on the line, the 
Emulation Program starts the session using the 'free' address. 

The addresses should be rotated to reduce the chance of an address 
conflict. For example, if there are four users (A, B, C, and D) 
sharing three addresses (1 , 2, and 3) the lists should be set up as 
follows. 



Figure 1 1-3. Workstation Address List 


User 


A 


B 


C 


D 


Address 
list 


1, 2, 3 


2, 3, 1 


3, 1, 2 


1, 2, 3 


Address 
one will 
likely get 


1 


2 


3 


1 (if user A 
is not 
online) 



Notes: 

1 . Do not mix display and printer addresses in the same address 
list. 

2. If two workstations attempt to use the same address at the same 
time, unpredictable results can occur. 

For more information about using address lists, see "Addressing 
Workstations" on page 2-9. 

Column Separator Character 

This option allows you to change the character used by the personal 
computer to emulate 5250 column separation. You can also change 
the character that appears in a host entry field when you type a 
blank with the Space bar. 

Type the character on the keyboard, and it appears. If the character 
you want is not on the keyboard, press and hold the Alt key while 
you type the hexadecimal value of the character on the numeric 
keypad. (To find the hexadecimal value of the character, see the 
Technical Reference manual for the code page that you are using.) 
For example if you wanted the separator character to be a solid 
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block, you would enter the decimal value 219, which represents the 
character at hex code point x' DB 1 in code page 850. 



Advanced Printer Options 

The following advanced printer options are available: 

• Printer hardware characteristics 

- Enable/disable printer alarm 

- Printer paper width 

- Characters per inch 

- Lines per inch 

- Prompt to change character density 

- Initial paper handling equipment 

- 5219 Printer hardware options 

- Number of cut sheet drawers 

- Envelope hopper 

• Customize printer EBCDIC to ASCII table 

• Customize printer initialization string 

• Select parallel or serial printer options 

The options for customizing the printer appear when you choose 
Select Printer Emulation Options from the Advanced Options menu. 

Printer Hardware 
Audible Alarm 

If the audible alarm is enabled, the Emulation Program sends a BEL 
command to the personal computer printer when the host sends a 
BEL command or when a graphic check occurs. The audible alarm 
is enabled by default. 

Printer Paper Width 

You can specify a paper width of either 8 or 13.2 inches. When a 
personal computer printer with a paper width of 8 inches is used to 
emulate a 5256, 5224, or 5219 printer, the Emulation Program does 
not allow printing beyond 8 inches. If the auto new line function is 
active, a new line operation equivalent to the New Line single byte 
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control is performed before printing the next graphic character. If the 
auto new line function is deactivated, an exception condition occurs. 

CPI and LPI Selection 

When emulating a 5256 or 5224 printer, you can specify the default 
characters per inch (CPI) and lines per inch (LPI). The Emulation 
Program uses these defaults until a print job requests a specific CPI 
or LPI. If these values are not supplied, the Emulation Program uses 
10 CPI and 6 LPI. 

User Prompt for Font Change 

When using 5219 or 5224 printer functions, you may need to change 
the physical font element to change the CPI. For example, the IBM 
5216 requires a printwheel change. This option allows you to specify 
whether the attached printer has this requirement. If you specify that 
a prompt is required, the Emulation Program requests a font change 
each time the CPI is changed by the host. Otherwise, the Emulation 
Program sends the CPI change to the printer and no user 
intervention is requested. 

You can also use this option if you have defined a non-supported 
printer to use 5219 printer functions. If you define a control 
sequence in the printer function table to change the font and request 
no prompt with this option, the Emulation Program sends the 
command internally to change the font instead of prompting with the 
Change Font indicator. 

Paper Handling Equipment 

This option allows you to specify whether the printer uses continuous 
forms or cut sheets. The Emulation Program uses this option to 
determine how to perform page ejection. 

5219 Printer Paper Feed Hardware 

You can specify the type of paper feed hardware you want to attach 
to the printer. If a print job requests a type of paper feed that is not 
defined for your printer, the Emulation Program requests manual 
insertion of the required form. These types of paper feed hardware 
can be specified: 

• One or two drawers 

• Envelope feed 
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Customize Host to Printer Code Page Mapping 

Use this option to modify the translation of host EBCDIC characters 
to printer ASCII characters. Changing the tables affects only how 
the characters are printed, not what is sent from the host. For 
details on modifying the table, see "Customize Host to PC Display 
Code Page Mapping" on page 11-3. 

The session profile maintains two of these tables, one for the display 
and one for the printer. Modifications to the printer table do not 
affect the display table. 

Printer Initialization String 

Up to 32 bytes of initialization data may be specified for the printer. 
Each time you start the printer session, the Emulation Program 
sends the initialization data to the printer. 

Parallel Attachment Options 

If the personal computer printer is parallel attached, you can specify 
LPT1, LPT2, or LPT3 as the port used to communicate to the printer. 
The default port is LPT1 . 

Serial Attachment Options 

To configure a serial (asynchronous) attached printer, you need to 
know the following information: 

• Async port name (COM1 or COM2) 

• Communication speed (baud rate) 

• Number of data bits per frame (7 or 8) 

• Number of stop bits per frame (1 or 2) 

• Use of parity bit (none, even, or odd) 

This information depends on how your particular serial attached 
printer is configured. For specific information, see the operator's 
manual that was provided with the printer. 

Note: The Emulation Program cannot distinguish between 
Not Ready and End of Forms conditions for serial attached printers. 
If either condition occurs, the Emulation Program reports that the 
attached printer is offline. 
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Appendix A. Error Codes and Messages 



This appendix contains all error codes and messages for the 
Emulation Program. This information is from the following sources: 

• Communications Errors 

• Configuration Messages 

• Controller Errors 

• Data Stream Errors 

• Initialization Messages 

• Four-Digit Error Codes 

• Operator Errors 

• 5219 Printer Messages 

• 5224 Printer Messages 

• 5256 Printer Messages 

Note: References to specific keys are related to the personal 
computer style of keyboard customization file. If you are using a 
different style of keyboard customization file or if you have redefined 
any of the keys, use the appropriate key. 

If a keying error occurs when you are typing information while in an 
emulated session, a four-digit error code is displayed on the screen 
(usually on the last line). Find the four-digit error code in "Four-Digit 
Terminal Error Codes" on page A-1 3 follow the recovery procedure. 

If keystroke buffering was selected, additional keystrokes are 

buffered and must be cleared using the Error Reset key or the 

I Reset key sequence before further recovery actions can be taken. 
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If keystroke buffering was not selected: 

• The host ignores any additional data entered from the keyboard. 

• The personal computer beeps each time you press a key. 

Notes: 

1. Error codes 0040 through 0054 are communication type errors 
and are valid when the personal computer is attached as a 
remote workstation through the IBM 5294 or IBM 5394 
controllers. These errors must be corrected at the controller. 

2. With printer emulation, the Emulation Program can only detect 
the end of forms (out of paper) and printer not ready conditions 
on the personal computer printers. If you do not know how to 
respond to a printer message, see the operator's guide for the 
printer you are using. 



Using the Help Function 

Some hosts provide help for error recovery. If an error code is 
displayed after you sign on to the host, press the emulated Help key. 
A message is displayed describing the error condition. After you 
finish reading the message, press the emulated Error Reset key and 
follow the recovery procedure listed for the error code. You should 
then be able to continue typing data on your personal computer. 



Additional Information 

Additional error information can be found in the host system 
messages manual. If you are not able to recover from an error refer 
to Appendix B, Problem Determination. 
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Error Codes and Messages 
aaaaa.bbb, File Not Found (Error 100) 

You requested a file name on the command line (using \=aaaaa.bbb) 
that was not on the requested (or default) drive. The Emulation 
Program displays this message, then returns control to DOS. A 
requested file must exist if the Emulation Program is to run. 

aaaaa.bbb, Unusable Initialization Data (Error 200) 

The configuration file exists, but does not contain data in the proper 
format for configuration data. The configuration file is generated by 
the configuration program (CONFIG.EXE) and can only be edited by 
CONFIG.EXE. If the Emulation Program does not recognize the 
configuration data, it displays this message and returns control to 
DOS. You should delete the configuration file and run CONFIG.EXE 
to generate a new file. 

aaaaa.bbb, Unusable Printer Function Table 

The Printer Function Table exists, but does not contain data in the 
proper format. A printer function table is generated by the 
PFTSETUP program (PFTSETUP.EXE) and can only be edited by 
PFTSETUP.EXE. If the Emulation Program does not recognize the 
configuration data, it displays this message and returns control to 
DOS. You should delete the PFT file and run PFTSETUP.EXE to 
generate a new file. 

x — Invalid Letter on Command Line 

The letter x on the command line is not recognized as a valid option. 
The error is usually caused by not entering an l=, K=, or P= before a 
file name. 

Attached Printer Offline (5219, 5224, 5256 Emulation) 

The printer was not online when you requested a printer operation. 

This message is removed when the Start option is successfully 
completed by the program. 
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Attached Printer Offline: Data Loss May Have Occurred (5219, 
5224, 5256 Emulation) 

The Emulation Program tried to send host data to the printer, but a 
printer not ready condition exists. 

The printer's internal buffer may have lost some information. The 
host is only informed that the printer is not available. It is not aware 
of any possible loss of information. If any information is lost, see the 
appropriate host recovery procedures. 

This message is removed when the Start option is successfully 
completed by the program. 

Note: If you do not know how to respond to an error message, see 
the operator's guide for the printer you are using. 

Cannot Continue, Press Any Key to Exit 

No address is available on the address list for the first session. 
Press any key to return to DOS. 

DOS Version Not Supported 

The Emulation Program requires DOS Version 5.0 or later. 
End of Forms (5219 Emulation) 

When an end of forms (out of paper) condition is shown, the 
following happens: 

• The Ready indicator is turned off. 

• The End of Forms indicator is turned on. 

• The host is notified of the end of forms condition. 

To recover: 

1 . Insert paper and make the printer ready. 

2. Select the Start option on the emulated operator panel. The 
Ready indicator is turned on. 
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End of Forms (5224 Emulation) 



When an end of forms (out of paper) condition is shown, the 
following happens: 

• The Ready indicator is turned off. 

• The Attention and Forms indicators are turned on. 

• The host is notified of the End of Forms condition. 

To recover: 

1 . Insert paper and make the printer ready. 

2. Select the Stop/Reset option on the emulated operator panel. 
The Attention and Forms indicators are turned off. 

3. Select the Start option on the emulated operator panel. The 
Ready indicator is turned on. 

End of Forms (5256 Emulation) 

When an end of forms (out of paper) condition is shown, the 
following happens: 

• The Ready indicator is turned off. 

• The Attention and Forms indicators are turned on. 

• The host is notified of the End of Forms condition. 

To recover: 

1. Insert paper and make the printer ready. 

2. Select the Stop/Reset option on the emulated operator panel. 
The Attention and Forms indicators are turned off. 

Note: If the printer was turned off to correct the End of Forms 
condition, select the Suspend option before you select the 
Stop/Reset option. 

3. Select the Start option on the emulated operator panel. The 
Ready indicator is turned on. 

Invalid File Name 

Not a valid file specification. For the proper way to name and 
specify files, see the manual for your operating system. 
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Invalid Option (5219, 5224, 5256 Emulation) 

You have selected an option that does not appear on the emulated 
operator panel. 

This message is removed when a valid option is selected. 
Line Check on Station Address x 

The Emulation Program received data it did not recognize from the 
host while starting the program (for example, the data contained a 
parity error). This message suggests a possible hardware error in 
the host, the cable, or the personal computer. 

1. Cancel emulation. The personal computer is returned to DOS 
and no sessions are active. 

2. Retry. The Emulation Program retries the address list. 

If the problem keeps coming back, refer to "Line Check Error" on 
page B-6, for more information. 

Output Data Field Values (5219 and 5224 Printer Emulation) 

The output data codes for the IBM 5219 and 5224 printers are listed 
in Figure A-1 on page A-7. These codes may show a print font, a 
feature, or a condition that has occurred on your printer. Check the 
table first, then follow these instructions. 

if a print font was requested, refer to the information provided for you 
or request help from your host system operator. 

If the host is expecting a printer operation to occur that uses a 
feature of your printer, follow the instructions given in the operator's 
manual for the printer you have attached. 

If an error condition occurred, follow the instructions given in the 
operator's manual for the printer you have attached. 



A-6 Enhanced 5250 User's Guide 



Figure A-1 describes the output data field values. The columns are: 



Column Contents 

Value Output data field value 

Setup Setup indicator on (if x) 

Form Form indicator on (if x) 

Except Printer Exception indicator on (if x) 



Operator Action Requested operator action 

The requested operator action for each of the output data values in 
Figure A-1 requires that the operator perform the action listed and 
then select the Start option. 



Figure A-1 (Page 1 of 2). Printer Output Data Field Values 


Value 


Setup 


Form 


Except 


Operator Action 


Dial lt\ 




v 

A 




1 naH n q nor 
LUdU fJdptil . 


01 


X 






Manual paper feed selected. 
Install appropriate device. 


01 




X 




Manual paper feed override. 
Feed paper from drawer 1 . 


02 


X 






Tractor feed selected. 
Install appropriate device. 


02 




X 




Manual paper feed override. 
Feed paper from drawer 2. 


03 


X 






Automatic sheet feed 
selected. Install appropriate 
device. 


0E 




X 




Manual paper feed override. 
Feed from envelope feed. 


10-14 
16-17 
20-26 
30-32 
40 






X 


Contact the host or 
controller operator and 
report a formatting error. 
(Include the value in the 
Output Data field.) 
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Figure A-1 (Page 2 of 2). Printer Output Data Field Values 


Value 


Setup 


Form 


Except 


Operator Action 


55 








Controller stopped the 
printer. Contact your host or 
controller operator for 
directions. 


D1 




X 




Paper feed type is 
continuous tractor. Change 
to source drawer 1 . 


D2 




X 




Paper feed type is 
continuous tractor. Change 
to source drawer 2. 


Any 
Num- 
ber 








If the Change Font indicator 
is on, change to the font 
shown by the host system 
programmer. 



Printer Emulation Suspended (5219, 5224, 5256 Emulation) 

You have suspended printer emulation, and the printer can now be 
used by a DOS application program. 

This message is removed when the Start option is selected. 
Waiting for System Avail at Station Ax 

The Emulation Program waits approximately 10 seconds for the host 
to respond. 

5250 Emulator Already Loaded 

The Emulation Program is already loaded. You may not load more 
than one copy of the code in the personal computer at the same 
time. The first copy still functions normally. 

5250 Hardware Diagnostic Failure 

The initialization program detected a possible hardware error. Run 
the diagnostic program for the adapter using the instructions in the 
Guide to Operations or Installation and Test Instructions manual that 
was supplied with the adapter. The personal computer returns to 
DOS. 
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Keyboard Customization File Errors 
= Sign Missing or Misplaced 

The equal (=) sign must be separated from other characters by at 
least one space or tab. This syntax error message indicates where 
the error occurred. 

Caps Lock Function Definable Only to Caps Lock Key 

The Caps Lock function may be assigned to the shifted and 
unshifted mode of only the Caps Lock key. This syntax error 
message indicates where the error occurred. 

Caps Lock Function Not Definable in Alternate Mode 

The Caps Lock function may not be assigned in a playback 
sequence. This syntax error message indicates where the error 
occurred. 

Carriage Return or Line Feed Missing 

This error occurs if the editor used to create or modify your keyboard 
customization file does not put a carriage return or line feed at the 
end of each line. Most editors do this for you. This syntax error 
message indicates where the error occurred. 

Define Not Found 

The first word of each line in the keyboard customization file must be 
DEFINE. This message is displayed when the keyword DEFINE is 
missing, misplaced, or misspelled. The word can be shortened, but 
at least the first three characters, DEF are required. The keyword 
can be uppercase, lowercase, or both. This syntax error message 
indicates where the error occurred. 

Definition Line Exceeds 512 Characters 

A definition record was found that exceeds the maximum record 
length of 512 characters. The first 512 characters of the record 
follow this message on the screen. 
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File Empty 

The file contains no records. 
File Not Found 

A file was not found in the current or specified subdirectory on the 
requested or default drive. 

Invalid Character 'x 5 Found 

A character (x), which is not available on a 5250 display, was found 
in a definition. Refer to the EBCDIC character sets in the Technical 
Reference manual for a list of the valid 5250 characters. This syntax 
error message indicates where the error occurred. 

Invalid Drive Name 

An invalid drive was specified for the keyboard customization file in 
the configuration file or as an execution time parameter. 

Invalid File Name 

A file name that does not meet the requirements for your operating 
system was requested. 

Invalid Mode Definition 

The definition record is trying to assign a shift mode that is not valid. 
The valid shift modes are: 

• Alternate (a-keyname) 

• Shifted (s- keyname) 

• Nonshifted (keyname) 

where keyname refers to the name of the key on the personal 
computer. This syntax error message indicates where the error 
occurred. 
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Invalid Scan Code 

The value of the hexadecimal number used for the personal 
computer scan code is not in the range of hex 01 through 7F. The 
number must contain two digits. Refer to scan code table in the 
Technical Reference manual for the valid scan codes. This syntax 
error message indicates where the error occurred. 

Key Not Definable in Alternate Mode 

The Alt, Ctrl, and Scroll Lock keys cannot be defined in alternate 
mode. The Emulation Program uses these keys for special 
purposes. For example, Alt+Ctrl is used to display the workstation 
address where the keyboard buffer indicator is normally displayed. 
This syntax error message indicates where the error occurred. 

No Definition 

No text follows the keyword DEFINE on the definition line. The 
keyword must be followed by an equal sign and a valid 5250 
function. For a description of the DEFINE command, see "Changing 
the Keyboard Customization File" on page 6-8. This syntax error 
message indicates where the error occurred. 

Null Definition 

A null definition is not allowed. Null definitions are two delimiters 
running side by side. For example: 

def s-a = "" 

def a-a = "This [] 'has a null definition.' 
def a-s = ""And so does this one!" 

This syntax error message indicates where the error occurred. 

Num Lock Function Definable Only to Num Lock Key 

The Num Lock function may be assigned to the shifted and unshifted 
mode of the Num Lock key only. 

Num Lock Function Not Definable in Alternate Mode 

The Num Lock function may not be assigned in a playback 
sequence. 



Appendix A. Error Codes and Messages A-1 1 



PC Key Name Not Found 

Nothing was found on the definition line after the keyword DEFINE. 
There must be some text following DEFINE. This syntax error 
message indicates where the error occurred. For a description of the 
DEFINE command, see "Changing the Keyboard Customization File" 
on page 6-8. 

Playback Sequence Exceeds 510 Bytes 

All available space for storing playback sequences is used. You 
must shorten the playback sequences until they all fit into the 
510-byte limit. 

Playback Sequence Not Allowed after Hot Key to DOS 

Playback sequences may not be continued after the sequence 
causes a hot key to the DOS session. Direct hot keys to DOS with 
additional playback data are flagged with this error message. Hot 
keys to DOS from a round robin hot key cannot be detected during 
keyboard customization. When they occur online, the playback 
sequence is ended. 

Shift Keys Are Not Definable 

The left and right personal computer shift keys (scan codes 2A and 
36) are always defined as shift keys and cannot be changed. A shift 
key cannot be assigned a string or function. The shift keys can only 
be used with other keys to select a character or function. 

String or Function Delimiter Missing 

The string delimiter (' or ") or function delimiter ([ or ]) is missing or 
misplaced on the right of the equal sign. Strings must begin and end 
with the same delimiter (' or "), and the delimiter may not be used 
inside the string. Functions must begin with a left bracket ([) and 
end with a right bracket (]). 
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0000 • 0001 



Unknown Function Name 'xxxx 1 

A function name (xxxx) that is not available on a 5250 display .was 
found in a definition. For a list of valid function names, see 
Figure 6-4 on page 6-11. 

The function names can be in uppercase, lowercase, or both. 
Unknown Personal Computer Key Name 

An invalid name was used for a personal computer key name. For a 
list of valid key names, see Figure 6-3 on page 6-10. The special 
names can be uppercase, lowercase, or both. Common errors are to 
put a 5250 function name to the left of the equal sign or to put a 
blank within the personal computer key name. 

1 Character or Function Only 

Only one character or function may be assigned to each key in the 
nonshifted mode. You must use the alternate mode to assign a 
string. 



Four-Digit Terminal Error Codes 

0000 No Help Text Available 

Meaning: You have pressed the emulated Help key; however, 
either no error code was displayed or the error was issued by a 
program that does not support this function. 

Action: Press the emulated Error Reset key. Then either continue 
or refer to the meaning of the previously displayed error code and 
take the action described. 

0001 Keying Too Fast 

Meaning: The host or controller could not keep up with the rate at 
which you were pressing keys, and the last keys pressed were not 
recognized. 

Action: Press the emulated Error Reset key and then continue. 
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0002 • 0006 

0002 Received Invalid Code 

Meaning: The host or controller received a key code that is not 
valid and therefore does not recognize which key you pressed. 

Action: Press the emulated Error Reset key and try to continue. 

0003 Key Not Command Key 

Meaning: You pressed the emulated Cmd key, but the next key you 
pressed was not one of the command function keys. 

Action: Press the emulated Error Reset key and continue by using 
a valid key sequence. 

0004 Protected Field 

Meaning: You attempted to press a key for a field that does not 
allow keyboard input. This field is an input/output feature field. 

Action: Press the emulated Error Reset key. 

0005 Protected Field 

Meaning: You attempted to press a key for a field that is not an 
input field. Data cannot be entered into a protected area of the 
screen. 

Action: Press the emulated Error Reset key and move the cursor to 
a valid input field. 

0006 Invalid Entry 

Meaning: After pressing the emulated Attn key and before pressing 
either the emulated Enter key or the emulated Error Reset key, you 
pressed a key that is not valid. 

Action: Press the emulated Error Reset key and use a valid key 
sequence. 
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0007 • 0011 



0007 Must Enter Field 

Meaning: There is at least one mandatory field on the screen into 
which you must enter data before the screen can be changed or 
moved. (The cursor goes to the first character position of the first 
mandatory entry field requiring data.) 

Action: Press the emulated Error Reset key and press the required 
keys. 

0008 Alphabetic Only Field 

Meaning: The field into which you are trying to enter data takes 
only alphabetic data, and you pressed a nonalphabetic character. 
Valid characters are A through Z, blank, comma, period, and hyphen. 

Action: Press the emulated Error Reset key and continue by 
pressing valid keys. 

0009 Numeric Only Field 

Meaning: The field into which you are trying to enter data takes 
only numeric data, and you pressed a nonnumeric key. Valid 
characters are 0 through 9, blank, comma, period, plus, and minus. 

Action: Press the emulated Error Reset key and continue by 
pressing valid keys. 

0010 Signed Numeric Only Field 

Meaning: The field into which you are trying to enter data takes 
only signed numeric data, and you pressed a key that is not valid. 
Valid characters are 0 through 9. 

Action: Press the emulated Error Reset key and continue by 
pressing valid keys. 

001 1 Sign Position Only 

Meaning: You attempted to put data into the last position of a 
signed numeric field. 

Action: Press the emulated Error Reset key. Make sure that the 
data is correct and exit the field by using the emulated Field- key or 
the emulated Field+ key. 
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0012 • 0015 



0012 Field Full 

Meaning: There is no room in this field to enter data. Either there 
is no more room in the field or the cursor is in the last position of the 
field. 

Do not use insert mode to change data or to enter data into the last 
position of this field. 

Action: Press the emulated Error Reset key. Then correct the field, 
if necessary, and continue. 

0013 Insert Mode On 

Meaning: You attempted to leave a field while the personal 
computer was still in insert mode. 

Action: Press the emulated Error Reset key and exit the field 
normally. 

0014 Must Fill Field 

Meaning: You pressed a function key that would move the cursor 
out of this field; however, the requirements of this mandatory fill field 
are not met. A mandatory fill field must be completely filled or left 
blank. 

Action: Press the emulated Error Reset key. Fill the entire field, or 
move the cursor to the start of the field and then use the emulated 
Field- key or the emulated Field+ key. 

0015 Does Not Compare 

Meaning: You entered data into a self-check field; the number and 
the check digit you just entered do not compare. 

Action: Press the emulated Error Reset key. Check that you used 
the correct number and check digit. If you used the correct 
characters, check that the number is valid for a self-check field. 
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0016 • 0019 



0016 Not Signed Numeric Field 

Meaning: You pressed the emulated Field- key, but the field you 
are in is not a signed numeric field or (for some hosts) a numeric 
only field. 

Action: Press the emulated Error Reset key. Continue by pressing 
data keys or pressing the emulated Field+ key. 

0017 Field Not Full 

Meaning: You pressed the emulated Field- key or the emulated 
Field+ key; however, the requirements for this mandatory fill field are 
not met. A mandatory fill field must be completely filled unless you 
exit from the first position of the field. 

Action: Press the emulated Error Reset key. Then continue by 
pressing data keys to fill the field or by moving the cursor to the start 
of the field and using the emulated Field- key or the emulated Fields- 
key. 

0018 Nondata Key Required 

Meaning: You must use a nondata key (such as emulated Field+, 
emulated Field-, emulated Field Exit, or a cursor movement key) to 
leave this field. 

Action: Press the emulated Error Reset key. Then use a nondata 
key to leave this field. 

0019 Dup Key Not Allowed 

Meaning: You pressed the emulated Dup key; however, the Dup 
key is not permitted in this field. 

Action: Press the emulated Error Reset key and continue without 
using the emulated Dup key in this field. 
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0020 • 0023 



0020 Right Adjusted or Signed Numeric Field 

Meaning: You pressed a key that is not allowed in this field. This 
is either a right-adjusted or a signed-numeric field, and you must exit 
the field before pressing any of the following keys: Backspace, 
emulated Enter, emulated New Line, emulated command, emulated 
Help, emulated Roll Up, emulated Roll Down, and emulated Home 
(when the cursor is in the home position). 

Action: Press the emulated Error Reset key. The cursor is in the 
same position it was in when you pressed the key that was not valid. 
Continue by pressing the emulated Field- key or the emulated Field+ 
key. 

0021 Must Enter Field 

Meaning: The cursor is positioned in a mandatory enter field. A 
mandatory enter field must have data in it before you can exit the 
field by pressing the emulated Field+ or the emulated Field- key. 

Action: Press the emulated Error Reset key and then press the 
required data keys. 

0022 System Error 

Meaning: A host error occurred. The status of the present field is 
not known. This error can occur during an insert or delete operation. 

Action: Press the emulated Error Reset key. Check the screen to 
determine whether the insert or delete function was completed 
properly. If not, correct the field. 

0023 Nonhexadecimal Key 

Meaning: You are in hexadecimal mode, but the first key pressed 
was not an A through F key or a 1 through 9 key; or the second key 
pressed was not an A through F key or 0 through 9 key. 

This error also occurs when a hexadecimal code is used in a 
numeric only, signed numeric, alphabetic only, or input/output field. 

Action: Press the emulated Error Reset key. Continue by pressing 
the correct key. 
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0026 • 0043 



0026 Numeric Only Field 

Meaning: You pressed the emulated Field- key to exit a numeric 
only field, but a number from 0 through 9 was not in the last position 
of the field. 

Action: Press the emulated Error Reset key. Correct the last 
position of the field or exit the field by using the emulated Field+ key. 

0028 Key Not Assigned 

Meaning: You pressed a key that is not used by this program. 

Action: Press the emulated Error Reset key and continue by 
pressing a valid key. 

0029 Not Diacritic Key 

Meaning: The second key pressed during a diacritic key function 
did not result in a valid combination. 

Action: Press the emulated Error Reset key and enter a valid 
combination. 

0040 Data Set Not Ready 

Meaning: The 'data set ready' line is inactive, and it should be 
active. 

Action: Notify the controller operator. 

0042 Receive Clock Field 

Meaning: The receive clock signal failed during a receive operation. 
Action: Notify the controller operator. 

0043 Data Set Ready 

Meaning: The 'data set ready' line is active, and it should be 
inactive. 

Action: Notify the host or controller operator. 
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0044 • 0099 



0044 Not Receiving Data 

Meaning: The 30-second communication time-out expired with no 
valid data being received. 

Action: Notify the controller operator. 

0050 Clear and Request to Send Not Together 

Meaning: Either the 'clear to send' line was inactive while the 
'request to send' line was active or the 'clear to send' line was active 
while the 'request to send' line was inactive. 

Action: Notify the controller operator. 

0051 Transmit Clock Failed 

Meaning: The transmit clock signal failed during a transmit 
operation. 

Action: Notify the controller operator. 

0052 Controller Error 

Meaning: The controller detected an internal error. 
Action: Notify the controller operator. 

0054 Controller Received Invalid Command 

Meaning: The controller received a command that is not valid from 
the host. 

Action: Notify the controller operator. 
0099 Host Not Available 

Meaning: A key that required host action was pressed, and the 
host was not available. 

Action: Determine when the error occurred (before, during, or after 
signon), and then see Appendix B, "Problem Determination" for more 
information. 
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Appendix B. Problem Determination 



This appendix can help you solve a problem with your personal 
computer and the 5250 Emulation Program. Check to see if any of 
the symptoms describe your problem, and take the corrective action. 



Cursor Blinking Upper Left 



■ 



Figure B-1. Cursor Blinking Upper Left 



Meaning: 

The cursor is blinking in the upper left corner of the screen. 
Action: 

1 . The System/38 may have varied this session offline. 

This only applies to a System/38 that is running a CPF release 
before release 6.0, program change C. Program change number 
06076 in program change C corrects this problem. 

System/38 varies offline a display following the fourth time it is 
powered off without a user signing on. The display must be 
varied online (VRYDEV) before it can be used again. 

The system continues to vary the display offline each time it is 
subsequently varied online, powered on, and powered off without 
a user signing on. On the eighth consecutive power off 
(including the first four, noted above), a warning message is sent 
to the QSYSOPR message queue. On the ninth occurrence, the 
display's subsystem deallocates the device. The only way to 
recover, at this point, is to terminate (TRMSBS) and restart 
(STRSBS) the subsystem. 
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The counters are reset each time a user signs on to the display. 

When invoking the Emulation Program, a user must sign on to 
each emulated display at least once every fourth time. This is 
generally not a problem with the first session. But, the second 
session may be configured as a display session and not used. 
The screen for the offline session will be blank except for the 
cursor in the upper left corner and the status indicators displayed 
with System Available on. 

2. Contact the host system operator and make sure the host is 
operating correctly. 



Cursor Blinking Upper Right 



Figure B-2. Cursor Blinking Upper Right 
Meaning: 

The cursor is blinking in the upper right corner of the screen. 
Action: 

1. Contact the host system operator and make sure the host is 
operating correctly. 

2. Make sure that the cable between your personal computer and 
the host is securely fastened and is not visibly damaged. 

3. Make sure the workstation address in the session profile is 
correct. Ask your host system operator for assistance. 

4. Make sure that only the last workstation on your cable is 
terminated. Ask your host system operator for assistance. 
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5. If the cursor is still blinking in the upper right corner of the 
screen, run the diagnostic program for the adapter using the 
instructions in the Guide to Operations or Installation and Test 
Instructions manual that was supplied with the adapter. 

6. If the problem persists, report to the host system operator that 
your workstation is not communicating with the host. 



Error Occurred after Signon 

Meaning: 

If the workstation is locally attached, contact the host system 
operator to determine whether the host is available. If the 
workstation is attached through a controller, this error can be caused 
by a loss of communication between the controller and the host. 

Action: 

Press the emulated Error Reset key, then try to run a different type 
of job or procedure. If the error does not occur again, there is a 
system programming problem or a key that was not valid was 
pressed. If the error occurs again and the personal computer is 
attached to a controller, contact the controller operator to determine 
whether communications with the host was lost and whether the host 
is not available. For additional error information, contact the host 
system operator. 



Error Occurred before Signon 

Meaning: 

The function key you pressed is not valid now. 
Action: 

Press the emulated Error Reset key. Then use the correct 
procedure to sign on. 
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Error Occurred during Signon 



Meaning: 

Either the host is not operating or the controller is not communicating 
with the host. 

Action: 

Ask your host system operator for assistance. 



Four-Digit Error Code 



xxxx 



Figure B-3. Four-Digit Error Code 
Meaning: 

This error code is displayed in the four leftmost columns in the last 
row of the screen. 

Action: 

Find the error code in "Four-Digit Terminal Error Codes" on 
page A-13 and take the action recommended. 
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Keyboard Not Working 



Meaning: 

When you press any key, no data appears or incorrect data appears 
on the screen. 

Action: 

1. If the alarm sounds, the keyboard may be input inhibited. Press 
the emulated Error Reset key. 

If the alarm does not sound: 

a. Turn the personal computer off. Wait 10 seconds, then turn 
it on. 

b. Test the keyboard by pressing a few keys. If the screen 
remains blank, refer to your personal computer Guide to 
Operations and run the diagnostics supplied with the 
program. If the KB indicator is on, empty the keyboard 
buffer by pressing the Alt and Scroll Lock keys. 

2. If characters different from the ones pressed on the keyboard are 
displayed or you are getting keyboard errors displayed on the 
screen, you might not have the device configured with an 
enhanced keyboard. 

a. Change the device description on the host for your 
workstation so that it specifies an enhanced keyboard. 

b. If you are upgrading from Version 2.3 or earlier of the 
Emulation Program, you must reconfigure your 3196 device 
description for an enhanced keyboard. 
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Line Check Error 



XX 



Figure B-4. Line Check Error 



Meaning: 

The line check count is displayed as a decimal number at the left 
end of the status line. 

Action: 

1 . Make sure the cable between your personal computer and the 
host is securely fastened and is not visibly damaged. 

2. Make sure the workstation address in the session profile is 
correct. Ask your host system operator for assistance. 

3. Make sure that only the last workstation on your cable is 
terminated. Ask your host system operator for assistance. 

4. Turn the personal computer off. Wait 10 seconds, then turn it 
on. 
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Memory Error 



Meaning: 

If you receive a memory error message when trying to start the 
Emulation Program, there is no memory available to install your 
adapter. In many cases, this is a problem that occurs with memory 
managers. 

Action: 

For information about correcting the error, see "Memory Usage" on 
page 3-23. 



Printer Failure Not Defined 

Meaning: 

If the printer is not operating, you may have forgotten to turn it on 
before loading the Emulation Program. 

Action: 

If this situation occurs: 

1 . Suspend the printer session. 

2. Turn the printer on. 

3. Ready the printer. 

4. Start the printer session. 

5. Restart the host print job. 
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Problem Not Defined 



Meaning: 

A problem still exists. Your workstation is not operating as expected, 
and none of the symptoms described in this appendix apply to your 
situation. 

Action: 

1 . Contact your host system operator and make sure the host is 
operating correctly. 

2. Make sure the twinaxial cable between your personal computer 
and the host is securely fastened and is not visibly damaged. 

3. Make sure the workstation address in the session profile is 
correct. Ask your host system operator for assistance. 

4. Run the diagnostic program for the adapter using the instructions 
in the Guide to Operations or Installation and Test Instructions 
manual that was supplied with the adapter. 
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Transfer Facility Signon 



Meaning: 

When requesting data transfers using the IBM System/36 Transfer 
Facility PRPQ or the IBM System/38 Transfer Facility PRPQ, you 
must be signed on to session one. 

If you try to transfer data when you are not signed on to session one, 
the workstation signon screen is displayed, but keystrokes are not 
accepted. 

Action: 

If this situation occurs: 

1 . End the 5250 Emulation Program by performing a software reset 
(pressing Ctrl+Alt+Del) to return control to DOS. 

2. Restart the 5250 Emulation Program with DP5250, making sure 
to sign on to session one. 

3. Restart the Transfer Facility. 
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Appendix C. PCMCIA Setup Considerations 



The Enabler/Diagnostic Diskette that comes with the 5250 Emulation 
PCMCIA Adapter: 

1 . Tests your 5250 Emulation PCMCIA Adapter card 

2. Provides the necessary software to enable and configure your 
5250 Emulation PCMCIA Adapter 



1. It is recommended that you use Card Services to manage your 
system's resources for PCMCIA cards. For information about 
using Card Services, see "Installing Card and Socket Services" 
on page C-7. 

2. The 5250 Emulation PCMCIA Adapter requires DOS 5.0 or 
above to use the 5250 Emulation PCMCIA Adapter. To connect 
to your host system, you need an additional 5250 emulation 
package. 

3. If your 5250 Emulation PCMCIA Adapter is already in use by 
other software, do not configure it. Unpredictable results can 
occur. 



About the Enabler/Diagnostic Diskette 

The Enabler/Diagnostic Diskette contains the following directories: 
\ENB5250 Contains files that enable and start the 5250 



Notes: 



Emulation PCMCIA Adapter card in DOS mode. 
The SETUP program copies some of these files to 
your personal computer. 



\DIAG 



Contains files for testing the 5250 Emulation 
PCMCIA Adapter. 

Contains the DOS Card Services and Socket 
Services drivers for some IBM personal computers. 



\PCMCIA 



Note: There 



might be more directories. 



© Copyright IBM 



Corp. 1985, 1994 
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The following files are in the root directory of the Enabler/Diagnostic 
Diskette. 

README.TXT Contains any information about the 5250 Emulation 
PCMCIA Adapter that was not available when this 
manual was published 

SETUP.BAT Copies the enable and configuration software for 

DOS emulation programs to your personal computer 

CFG5250.BAT Sets or changes your 5250 Emulation PCMCIA 
Adapter configuration 

CONFIG.SYS Starts the diagnostics and the 5250 Emulation 
PCMCIA Adapter device drivers 

Note: There might be more files. 



Backing Up the Enabler/Diagnostic Diskette 

Make a backup copy of the Enabler/Diagnostic Diskette and keep the 
original diskette in a safe place. To make a backup copy of this 
diskette, either use the DOS DISKCOPY command or: 

1 . Format a new diskette with the IS option to copy the system files 
to the new diskette. 

Note: If you do not put the system files onto your diskette, the 
5250 Emulation PCMCIA Adapter tests will not start. 

2. Copy all the files and subdirectories to your new diskette using 
the DOS XCOPY command with the IS option. 



Testing the 5250 Emulation PCMCIA Adapter 

To test the 5250 Emulation PCMCIA Adapter: 

1. Put the backup copy of your Enabler/Diagnostic Diskette in the 
default drive. 

2. Reboot your personal computer by pressing the Ctrl+Alt+Del 
keys at the same time. 
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3. Follow the instructions the program gives. 

4. After the tests end, remove the diskette from the default drive 
and press Enter to restart your personal computer. 

Note: If you test the 5250 Emulation PCMCIA Adapter without 
configuring the diskette, the configuration program runs 
automatically. After configuring your diskette, enter CFG5250 to 
change the adapter configuration. 



Configuring the Enabler/Diagnostic Diskette 

To configure your Enabler/Diagnostic Diskette: 

1 . Place the backup Enabler/Diagnostic Diskette into the default 
diskette drive and make this drive the current drive. 

2. Enter CFG5250 and select the configuration parameters. This 
configures the Enabler/Diagnostic Diskette for use. 

3. Test the 5250 Emulation PCMCIA Adapter to ensure the 
Enabler/Diagnostic Diskette is properly configured and the 5250 
Emulation PCMCIA Adapter is operational. For more 
information, see "Testing the 5250 Emulation PCMCIA Adapter" 
on page C-2. 



Installing the 5250 Emulation PCMCIA Adapter 
Software 

To install the 5250 Emulation PCMCIA Adapter software: 

1 . Complete the steps in "Configuring the Enabler/Diagnostic 
Diskette." 

2. Return the Enabler/Diagnostic Diskette to the default diskette 
drive. Make this drive the current drive. 

3. To copy the software from the diskette to your personal 
computer, enter SETUP [drive:] [path] 

where [drive:][path] specifies the target directory for your 
software. You must specify a target directory. If the directory 
does not exist, the SETUP program creates it. 
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For example, to install your software in directory ENB5250 on 
drive C, enter: 

SETUP C:\ENB5250 

4. If directed by the SETUP program, add information to your 
CONFIG.SYS and AUTOEXEC.BAT files. 

5. Reboot your personal computer by pressing the Ctrl+Alt+Del 
keys at the same time. This causes the changes that you made 
to the CONFIG.SYS and AUTOEXEC.BAT files to take effect. 

6. From the directory that you specified in the SETUP program, run 
the ENB5250 program to enable your 5250 Emulation PCMCIA 
Adapter. If your adapter does not successfully enable, you might 
need to change your adapter or personal computer configuration. 
If your adapter tested without error in step 3, configuration 
problems are probably the result of conflicts with specifications in 
your CONFIG.SYS file. For information about a common 
CONFIG.SYS problem, see "Memory Managers" on page C-6. 

7. If you want to change your 5250 Emulation PCMCIA Adapter 
configuration, enter CFG5250 in the directory that you specified 
in the SETUP program. 



Configuration Support 

There is configuration support for personai computers that have Card 
Services support 2.00 or 2.01 . Higher levels of Cards Services might 
also work. 

It is recommended that you install PCMCIA Card Services on your 
personal computer and use this configuration option. Card Services 
manages your personal computer resources for your PCMCIA cards. 

The other configuration options directly program your personal 
computer hardware to enable the 5250 Emulation PCMCIA Adapter. 
If you configure your personal computer without PCMCIA Card 
Services, you must select system interrupts, I/O port addresses, and 
memory mapped addresses that the personal computer and other 
adapter cards are not using. 
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Using Card Services 

If you select the Card Services option, your personal computer must 
have: 

• Card Services 2.00 or above 

• Sockets Services 2.00 or above 

If you are using a ThinkPad computer, see "Using the ThinkPad 720" 
on page C-8 for information about using Card Services and Socket 
Services. 

Programming PCMCIA Controller Hardware 

There is configuration support for directly programming some 
PCMCIA controller hardware. Use this support only when Card 
Services Support 2.00 or above is not available for your personal 
computer. 



If you do not have PCMCIA Card Services 2.00 or above, select the 
configuration option in Figure C-1 that best matches your personal 
computer. 



Figure C-1. Supported PCMCIA Controllers 


PCMCIA Controllers 


Personal Computer 


IBM ThinkPad 


IBM ThinkPad 


SHARP PHIC 


Sharp 6700 Labtops 


Toshiba ICCCNT 


Toshiba 3300SL 


Intel** 82365SL PCIC 


• AST 

• NEC 

• Some Toshiba personal 
computers 

• Many other personal 
computers 



If your personal computer is not listed, try the option for the Intel 
82365SL PCMCIA support chip. Many personal computers use this 
PCMCIA support chip. If the Intel 82365SL PCMCIA support chip 
option does not work for your personal computer, ask your dealer 
which controller to use or call 1-800-955-5250. 



Appendix C. PCMCIA Setup Considerations C-5 



Selecting the wrong configuration information can cause hardware 
conflicts in your personal computer. The conflicts can cause the 
5250 Emulation PCMCIA Adapter tests, 5250 Emulation programs, or 
the configuration program (CFG5250) to fail. If a program fails, you 
must turn your personal computer off and on to clear all the 
hardware conflicts. Rebooting your personal computer by pressing 
the Ctrl+Alt+Del keys does not always clear hardware conflicts. 

Warning: If the 5250 Emulation PCMCIA Adapter is in use, running 
CFG5250 causes unpredictable results. Do not run CFG5250 while 
the adapter is in use by other software. 



Memory Managers 

The 5250 Emulation PCMCIA Adapter Card requires 8KB of 
available memory. You should ensure that any memory managers in 
your personal computer reserve some space to install the 5250 
Emulation PCMCIA Adapter and any other I/O adapters. 

For example, if your personal computer uses memory manager 
EMM386. SYS, the following command in the CONFIG.SYS file 
reserves a 64KB space, starting at segment address OxCOOO for 
installing I/O adapters. 

DEVICE=EMM386.EXE NOEMS X=C000-CFFF 

Note: You must restart your personal computer for any changes 
that you make in the CONFIG.SYS file to take effect. 

If you are using Card Services to enable your 5250 Emulation 
PCMCIA Adapter, you might need to reserve more than the 8KB 
space required for the adapter. Card Services support requires extra 
space for managing other PCMCIA adapters. 

For more information, see the documentation provided with your 
memory manager. For sample CONFIG.SYS files, see "Sample 
CONFIG.SYS Files" on page C-9. 
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Installing Card and Socket Services 

PCMCIA Card Services is software that manages personal computer 
resources for PCMCIA adapters. PCMCIA Card Services 2.00 is not 
provided with the 5250 Emulation PCMCIA Adapter. Card Services 
might be available as part of your operating system or from the 
manufacturer of your personal computer. 

Card Services 2.00 requires that Socket Services 2.00 be installed 
on your personal computer. Your personal computer might already 
have Socket Services 2.00, or Socket Services might be an option 
provided by the manufacturer of your personal computer. IBM-DOS 
6.1 provides Socket Services code for some IBM personal 
computers. (See the README.TXT file in IBM-DOS 6.1 for more 
information.) For information about using the IBM ThinkPad 720, see 
"Using the ThinkPad 720" on page C-8. 



Correction Service Diskettes on BBS 

Note: The IBM PC Company Electronic Bulletin Board System 
(PCC BBS) phone number that is given below is a United States 
phone number. 

Correction diskettes are available from the PCC BBS. You can call 
the PCC BBS at 1-919-517-0001 on a toll call basis, but with no 
access charge for the bulletin board. The requirements for the 
asynchronous electronic connection to the PCC BBS include: 

• A 1200 to 144000 baud modem set to 8 data bits, 1 stop bit, and 
no parity bits 

• Communication software that supports 8 data bit file transfer 

• A switched telephone line 
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Using the ThinkPad 720 

Attach the adapter cable before turning on your personal computer. 

Warning: After the 5250 Emulation PCMCIA Adapter is enabled, do 
not attach the adapter cable to the 5250 Emulation PCMCIA 
Adapter. Failure to attach the adapter cable before turning on your 
personal computer can cause the socket fuses in your IBM ThinkPad 
to permanently disable your PCMCIA socket. 

It is recommended that you install Card Services and use it to enable 
the 5250 Emulation PCMCIA Adapter. 

If you use the IBM ThinkPad configuration option and select the 
wrong slot, you must turn the computer off and on before you can 
use the correct slot. If you do not turn the IBM ThinkPad off and on, 
it will not detect the 5250 Emulation PCMCIA Adapter. 

To install Card and Socket Services 2.00 for the IBM ThinkPad 720 
from the Enabler/Diagnostic Diskette, change the following lines in 
the CONFIG.SYS file on the Enabler/Diagnostic Diskette: 

REM devi ce=\pcmci a\i bmdss02 . sys 
REM devi ce=\pcmci a\i bmdoscs . sys 
REM devi ce=\pcmci a\di crmu02 . sys 

to: 

devi ce=\pcmci a\i bmdss02 . sys 
devi ce=\pcmci a\i bmdoscs . sys 
devi ce=\pcmci a\di crmu02 . sys 

To enable your 5250 Emulation PCMCIA Adapter with Card and 
Socket Services, select Card Services 2.00 as a configuration 
selection. 

Some levels of Card and Socket Services 2.00 provided with the IBM 
ThinkPad 720 can cause your personal computer to restart when the 
5250 Emulation PCMCIA Adapter is enabled. If this happens, install 
the copy of Card Services and Socket Services that is in the 
PCMCIA directory on the Enabler/Diagnostic Diskette. 
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Note: If you do not have this problem, do not change the DOS Card 
and Socket Services software that you are using. 

To install the copy of Card Services and Socket Services: 

1. Copy the following files from the PCMCIA directory on the 
Enabler/Diagnostic Diskette to your personal computer. 

ibmdssG2.sys 
ibmdoscs.sys 
dicrmuG2.sys 

2. Add the following lines to your CONFIG.SYS file: 

devi ce= [dri ve :] [path] \i bmdssG2 . sys 
devi ce= [dri ve :] [path] \i bmdoscs . sys 
devi ce= [dri ve : ] [path] \di crmu02 . sys 

3. Remove any previous Card and Socket Services information in 
your CONFIG.SYS file. 



Using the SHARP PC-6700 

To use the 5250 Emulation PCMCIA Adapter Card with the SHARP 
PC-6700, configure an IC Card Com Port: 

1 . Press the setup key on the Sharp keyboard 

2. Under the Setup Option for Floppy Driver and IC cards, select 
IC Card Com Port and enter the requested information. 



Sample CONFIG.SYS Files 

This section contains sample CONFIG.SYS files for installing DOS 
Card and Socket Services and 5250 Emulation PCMCIA enabler 
support. These samples assume that the following directories exist. 

C:\DOS Contains all files provided by DOS. 

C:\PCMCIA Contains all drivers necessary to install Card and 

Socket Services 2.00 on your computer if the drivers 
are not provided with DOS. 
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C:\ENB5250 Contains specific drivers for enabling the 5250 
Emulation PCMCIA Adapter PCMCIA adapter. 
These drivers are provided by the 
Enabler/Diagnostic Diskette. 

Sample 1 

System: 

IBM ThinkPad 720 

Card and Socket Services Files: 

IBMDSS02.SYS, IBMDOSCS.SYS, DICRMU02.SYS 

Card and Socket Services Source: 

Either from the PCMCIA directory on the Enabler/Diagnostic Diskette 
or provided with your personal computer 

SHELL=C:\DOS\COMMAND.COM /P /E:512 
DEVICE=C :\PCMCIA\IBMDSS02 . SYS 
DEVICE=C:\PCMCIA\IBMDOSCS.SYS 
DEVICE=C:\PCMCIA\DICRMU02.SYS 
DEVICEHIGH=C:\ENB525O\CSDD5250.SYS 

Sample 2 

System: 

IBM ThinkPad 720 

Card and Socket Services Files: 

IBMDSS02.SYS, IBMDOSCS.SYS, DICRMU02.SYS 

Card and Socket Services Source: 

Either from the PCMCIA directory on the Enabler/Diagnostic Diskette 
or provided with your personal computer 

DEVICE=C:\DOS\HIMEM.SYS 

DEVICE=C r\D0S\EMM386.EXE NOEMS X=C0O0-CFFF 

D0S=HIGH,UMB 

SHELL=C:\D0S\C0MMAND.C0M /P /E:512 
DEVICE=C : \PCMCIA\IBMDSS02 . SYS 
DEV I C E=C : \PCMC I A\ I BMDOSCS . SYS 
DEVICE=C:\PCMCIA\DICRMU02.SYS 
DEVICEHIGH=C:\ENB5250\CSDD5250.SYS 
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Sample 3 

System: 

IBM ThinkPad 720 

Card and Socket Services Files: 

PCMSS.EXE, PCMCS.EXE 

Card and Socket Services Source: 

DOS 6.1 

DEVICE=C:\DOS\HIMEM.SYS 

DEVICE=C:\D0S\EMM386.EXE NOEMS X=C0O0-CFFF 
D0S=HIGH,UMB 

SHELL=C:\D0S\C0MMAND.C0M /P /E:512 
DEVICEHIGH=C: \DOS\PCMSS.EXE /APOFF 

DEVICEHIGH=C:\DOS\PCMCS.EXE /WAIT=12 /ADDR=C0 /IRQ=10 /NOPM 
DEVICEHIGH=C:\ENB5250\CSDD5250.SYS 

Sample 4 

System: 

IBM ThinkPad 720 

Card and Socket Services Files: 

PCMSS.EXE, PCMCS.EXE 

Card and Socket Services Source: 

DOS 6.1 

DEVICE=C:\DOS\HIMEM.SYS 

DEVICE=C:\D0S\EMM386.EXE NOEMS X=D800-DFFF 
DOS=HIGH s UMB 

SHELL=C:\DOS\COMMAND.COM /P /E:512 
DEVICEHIGH=C: \D0S\PCMSS.EXE /APOFF 

DEVICEHIGH=C:\DOS\PCMCS.EXE /WAIT=12 /ADDR=D8 /IRQ=10 /NOPM 
DEVICEHIGH=C:\ENB5250\CSDD5250.SYS 
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Sample 5 

System: 

IBM PS/2 E 

Card and Socket Services Files: 

IBMDSS01.SYS, IBMDOSCS.SYS, DICRMU01 .SYS 

Card and Socket Services Source: 

Either from the PCMCIA directory on the Enabler/Diagnostic Diskette 
or provided with your personal computer 

DEVICE=C:\DOS\HIMEM.SYS 

DEVICE=C: \D0S\EMM386.EXE NOEMS X=C000-CFFF 
DOS=HIGH,UMB 

SHELL<:\D0S\C0MMAND.C0M /P /E:512 
DEVICE=C:\PCMCIA\IBMDSS01.SYS /H 
DEVICE=C:\PCMCIA\IBMDOSCS.SYS 
DEVICE=C:\PCMCIA\DICRMU01.SYS 
DEVICEHIGH=C:\ENB5250\CSDD5250.SYS 
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Appendix D. Files on the Program Diskette 



The program diskettes include all the files necessary for configuring 
displays and printers. The files are listed below to help you 
understand the purpose of each file. 

Note: To edit these files, you must use the configuration program. 
Do not use a DOS editor to edit the Emulation Program files. 



Emulation Files 

The following files are used for emulation: 



File Name 

DP5250.COM 

CONFIG.EXE 

HWCONFIG.EXE 

xxxxxx^.PRO 



xxxxxxxA.PRO 



xxxxxxxE.PRO 



abc-xyz. TBL 



Description 

Emulation Program for either display or printer 
sessions 

Display and printer session configuration 
program 

Adapter configuration program 

Keyboard customization file for the Personal 
Computer, Personal Computer XT, Personal 
Computer XT 286, or Portable Personal 
Computer style keyboard, where xxxxxxx 
represents the keyboard for a specific country 

Keyboard customization file for the Personal 
Computer AT style keyboard, where xxxxxxx 
represents the keyboard for a specific country 

Keyboard customization file for the PS/2 
Enhanced keyboard or the PS/2 Space Saving 
keyboard, where xxxxxxx represents the 
keyboard for a specific country 

Code page translation table, where abc 
represents the EBCDIC code page, and xyz 
represents the ASCII code page 
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Printer Function Table Files 

The following files are used for printer function support: 



File Name 

PFTSETUP.COM 

PFTWS.PRN 

DEFAULT.PFT 

HPLASER2.PFT 
IBM2390.PFT 

IBM3812.PFT 
IBM4019.PFT 
IBM4072.PFT 
IBM4202.PFT 
IBM4208.PFT 
IBM4212.PFT 
IBM4226.PFT 
IBM5202.PFT 
IBM5204.PFT 



Description 

A program to create and edit PFTs 

A printer function table worksheet 

A sample printer function table for supporting 
other manufacturers' attached printers 

A printer function table for supporting 

HP LaserJet Printer Series II and III, and IBM 

4019 and 4029 Laser Printers in PCL mode 

A printer function table for supporting 
IBM Personal Printer Series (IBM 2380, 
2380 Plus, 2381, 2381 Plus, 2390, 2390 Plus, 
2391 , and 2391 Plus printers) 

A printer function table for supporting an 
IBM 3812 PagePrinter 

A printer function table for supporting IBM 4019 
and 4029 LaserPrinters in IBM PPDS mode 

A printer function table for supporting an 
IBM 4072 ExecJet Printer 

A printer function table for supporting an 
IBM 4202 Proprinter XL 

A printer function table for supporting an 
IBM 4208 Proprinter XL 24 

A printer function table for supporting an 
IBM 4212 Proprinter 24P 

A printer function table for supporting an 
IBM 4226 Printer 

A printer function table for supporting an 
IBM 5202 Quietwriter III 

A printer function table for supporting an 
IBM 5204 Quickwriter 
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PCL5.PFT A printer function table for supporting IBM 4039 

Laser Printers and HP LaserJet 4 Printers 

For more information about printer function tables, see Chapter 10, 
"Using the Printer Function Table Setup Program." 



Example Emulation Program Utilities 

These example utilities are to help you automatically start the host 
sessions and to help you use the Application Program Interface 
(API). 

File Name Description 

EMDP.BAT An AUTOEXEC program that automatically 

loads emulation with display and printer support 

EMPATCH.COM A patch program that allows updates to the 
Emulation Program 

A program that copies the contents of the 
emulated display screen to a diskette file. (The 
screen is displayed as it is saved.) 

A BASIC subroutine that checks whether the 
Emulation Program is loaded and initializes 
access pointers into the emulator data segment 

A program that transmits personal computer 
files to an attached host system 

A program that allows you to sign on 
automatically to the host from a BASIC 
application program 

A program that copies the contents of the 
emulated display screen to a diskette file. (The 
screen is not displayed as it is saved.) 

BASICA.COM The BASIC interpreter program that executes 
the BASIC (.BAS) programs that are supplied 
with the Emulation Program. 



SS2.BAS 

SUBS.BAS 

UL.BAS 
ASO.BAS 

SS.BAS 
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Appendix E. Keyboards 

This appendix provides reference information about keyboards, 
including: 

• How major 5250 functions are mapped to the personal computer 
keyboards 

• Which keyboard customization files are provided with the 
Emulation Program 

• How the enhanced-style keyboard is layed out for each of the 
supported languages 



Keys Used for 5250 Functions 

Figure E-1 shows how the basic 5250 functions are mapped to the 
enhanced-style, PC/XT-style, and PC/AT-style personal computer 
keyboards. 



Figure E- 1 (Page 1 of 3). Keys Used for 5250 Functions 


5250 Function 


Enhanced 
Keyboard 


PC/AT 
Keyboard 


PC/XT 
Keyboard 


Attention 


Esc 


SysReq 


Ctrl 


Bold 


Alt+B 


Alt+B 


Alt+B 


Center 


Alt+C 


Alt+C 


Alt+C 


Clear 


Pause 


Shift+Scroll 
Lock 


Shift+Scroll 
Lock 


Toggle Cursor 
style 


Alt+F9 


Alt+F9 


Alt+F9 


Cursor fast left 


Alt+Left 
arrow 


Alt+Pad4 


Alt+Pad4 


Cursor fast right 


Alt+Right 
arrow 


Alt+Pad6 


Alt+Pad6 


Duplicate 


Pad1 


Pad1 


Pad1 


End Bold 


Alt+J 


Alt+J 


Alt+J 


Enter 


Right Alt 


Enter 


Enter 
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Figure E-1 (Page 2 of 3). Keys Used for 5250 Functions 


5250 Function 


Enhanced 
Keyboard 


PC/AT 
Keyboard 


PC/XT 
Keyboard 


Erase input 


Alt+End 


Pad. 


Pad. 


Field exit 


Enter 


Alt+Enter 


Alt+Enter 


Field minus 


Pad- 


Pad- 


Pad- 


Field plus 


Pad + 


Pad + 


Pad+ 


Half index up 


Alt+Y 


Alt+Y 


Alt+Y 


Half index down 


Alt+H 


Alt+H 


Alt+H 


Help 


Scroll Lock 


Esc 


Esc 


Home 


Home 


Pad7 


Pad7 


Hexadecimal 
mode 


Alt+F7 


Alt+F7 


Alt+F7 


Hot key sequence 


Alt+Esc 


Alt+Esc 


Alt+Esc 


Immediate reset 


Alt+Scroll 
Lock 


Alt+Scroll 
Lock 


Alt+Scroll 
Lock 


Insert symbol 


Alt+A 


Alt+A 


Alt+A 


Next stop code 


Alt+N 


Alt+N 


Alt+N 


Next text column 


Alt+D 


Alt+D 


Alt+D 


Page end 


Alt+P 


Alt+P 


Alt+P 


Print host side 


Shift+Prtsc 


Alt+Pad* 


Alt+Pad* 


Print PC side 


Prtsc 


Shift+Pad* 


Shift+Pad* 


Required page 
end 


Alt+R 


Alt+R 


Alt+R 


Reset 


Left Ctrl 


Alt 


Alt 


Roll Down 


Page Up 


Pad9 


Pad9 


Roll Up 


Page Down 


Pad3 


Pad3 


Stop code 


Alt+S 


Alt+S 


Alt+S 


System request 


Alt+Prtsc 


Alt+Sysreq 


Shift+Ctrl 


Test request 


Alt+Pause 


Scroll Lock 


Scroll Lock 


Underline 


Alt+U 


Alt+U 


Alt+U 
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Figure E-1 (Page 3 of 3). Keys Used for 5250 Functions 


5250 Function 


Enhanced 
Keyboard 


PC/AT 
Keyboard 


PC/XT 
Keyboard 


Underline word 


Alt+W 


Alt+W 


Alt+W 


Command 1 - 

Cln in manrl If) 


F1 - F10 


F1 - F10 


F1 - F10 


C**r\ mmanrl "1 "1 
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Keyboard Customization Files 

The following keyboard customization files are provided with the 
Emulation Program. You can use one of these keyboard definitions 
or customize your own. 

If you are using a laptop computer, select a keyboard customization 
file for an enhanced-style keyboard. 
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For information about the provided keyboard definitions, see "Keys 
Used for 5250 Functions" on page E-1 . For information about 
changing the keyboard customization file or about assigning your 
own character and function keys, see "Changing the Keyboard 
Customization File" on page 6-8. For more detailed information, see 
the Technical Reference manual. 

The keyboard customization files listed in Figure E-2 are provided, 
where x represents the keyboard style: 

E Enhanced-style keyboards 
A PC/AT-style keyboards 
P PC/XT-style keyboards 



Figure E-2 (Page 1 of 2). Keyboard Customization Files 
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Canadian French IBM Enhanced 
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Danish IBM Enhanced Keyboard 
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Greek IBM Enhanced Keyboard 
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Icelandic IBM Enhanced Keyboard 


ICELAN-x.PRO 


Italian IBM Enhanced 142 Keyboard 


ITALY--* PRO 


Latin American/Spanish Speaking 


LATIN--*. PRO 


Norwegian IBM Enhanced Keyboard 


NORWEG-xr.PRO 


Portuguese IBM Enhanced Keyboard 


PORTUG-xPRO 


Spanish IBM Enhanced Keyboard 


SPAIN-x.PRO 


Swedish/Finnish IBM Enhanced Keyboard 


SWEFIN-x.PRO 
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Figure E-2 (Page 2 of 2). Keyboard Customization Files 
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Swiss-Bilingual-German IBM Enhanced 
Keyboard 


SWGER-x.PRO 


Turkish IBM Enhanced 179 Keyboard 


TURKEY-x.PRO 


U.K. English IBM Enhanced 168 
Keyboard 


UK x.PRO 


U.S. English IBM Enhanced Keyboard 


US x.PRO 



Keyboard Layouts 

Figure E-3 lists the enhanced keyboard layouts that the Emulation 
Program uses and the page number to see for each layout. 
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Figure E-5. Belgian IBM Enhanced Keyboard 
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Figure E-7. Canadian-French IBM Enhanced Keyboard 
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Figure E-8. Danish IBM Enhanced Keyboard 
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Figure E-9. Dutch IBM Enhanced Keyboard 
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Figure E-10. French (AZERTY) IBM Enhanced 120 Keyboard 
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Figure E-1 2. Icelandic IBM Enhanced Keyboard 
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Figure E-14. Latin American/Spanish Speaking IBM Enhanced Keyboard 
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Figure E- 15. Norwegian IBM Enhanced Keyboard 
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Figure E-18. Swedish/Finnish IBM Enhanced Keyboard 
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Figure E-19. Swiss-Bilingual-French IBM Enhanced Keyboard 
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Figure E-21. Turkish IBM Enhanced 179 Keyboard 
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Figure E-23. U.S. English IBM 
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Glossary 
A 

adapter. The part of a device or 
feature required to attach it to a 
processing unit. 

address. The number assigned to 
a device or to a location in memory. 

align. To bring into or be in line 
with another or with others. For 
example, to line up the numbers on 
the decimal point. 

allocate. To assign a resource, 
such as a disk or a diskette file, to 
perform a task. Contrast with 
deallocate. 

alphabetic keys. The letter keys 
a through z, blank, comma, period, 
and hyphen. 

alphanumeric. (1) Consisting of 
both letters and numbers and often 
other symbols (such as punctuation 
marks and mathematic symbols). 
(2) Capable of using alphanumeric 
characters. 

alternate mode. A method of 
operation that causes keys to be 
entered as characters or functions 
(for example, the Backspace key is 
represented as the clear function 
when the Alt key is held down). See 
also nonshifted mode and shifted 
mode. 



Alt state. The definition for the key 
when you press that key and an Alt 
key at the same time. 

application program. A program 
used to perform a particular data 
processing task, such as payroll. 

ASCII. American Standard Code for 
Information Interchange. The 
standard code using a coded 
character set consisting of 7-bit 
coded characters (8 bits including 
parity check), used for information 
interchange among data processing 
systems, data communications 
systems, and associated equipment. 
The ASCII set consists of control 
characters and graphic characters. 

async. See asynchronous. 

asynchronous (async). Not 

happening, existing, or arising at 
precisely the same time. 

attribute. The properties 
associated with the use of a device. 

authorize. To allow a user to 
communicate with or make use of an 
object, resource, or function. 

auto-configuration. The automatic 
arrangement of the parts of a 
computer. 

AUTOEXEC.BAT file. A batch file 
that contains DOS commands or 
program names that are executed 
immediately after DOS is started. 
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B 

back up. To copy information, 
usually onto a diskette, for 
safekeeping. 

backspace. To move back a 
position along a row. 

batch file. A file containing one or 
more commands that DOS executes 
one at a time. All batch files must 
have the extension of .BAT. 

beep. An audible tone at a display 
or printer that is used to get the 
operator's attention. 

binary. Pertaining to a numbering 
system with a base of 2. Valid digits 
are 0 (zero) and 1 (one). 

bit. The basic unit of computer 
information, such as 0 or 1. 

boot. Loading and executing the 
boot record. This is accomplished 
by pressing and holding the Ctrl and 
Alt keys and then pressing the Del 
key. 

boot record. A record stored on 
track 0 and sector 0 of a disk(ette) 
that contains a program designed to 
load the Disk Operating System into 
memory and start its execution. 

boundary. The division between 
each of 64KB blocks of physical 
storage addresses. 

buffer. A temporary storage unit 
that accepts data at one rate and 
delivers it at another rate. 



byte. The amount of storage 
required to represent one character; 
a byte is 8 bits. 

C 

cable splice. The physical 
connection between two pieces of 
twinaxial cable. 

Cable Thru feature. A special 
feature that allows more than one 
display station (except the 5251 
Model 2 or 12) and/or more than 
one printer to be attached to a single 
cable path. 

card. An adapter card that is 
installed in the personal computer to 
enable it to be connected to another 
device or to increase the size of the 
computer's memory. 

character codes. The ASCII or 
EBCDIC values assigned to the 
symbols or functions that are used 
by the personal computer or in the 
IBM 5250 Information Display 
System. 

character set. A set or style of 
alphabetic, numeric, and special 
characters that can be displayed or 
printed by the personal computer or 
a device in the IBM 5250 Information 
Display System. 

clicker. A mechanism that sounds 
when a key is pressed and accepted 
for processing. 

close a file. To remove a file from 
the program in which it is executing. 
Contrast with open a file. 
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column. The character position 
within a print line or on a display. 
The positions are numbered from 1 , 
by 1 , starting at the leftmost 
character position and extending to 
the rightmost position. 

column separator. The character 
symbol displayed at the beginning 
and end of each column in an input 
field. 

command line. (1) A DOS 

command and any associated 
parameters, file names, and so on. 
(2) The line on the display screen 
following the DOS prompt where you 
type a DOS command. 

compatible. The ability of one 
device to work with another without 
the need to change either device. 

CONFIG.SYS. A personal computer 
file that contains the device driver 
assignments. 

configuration. The group of 
machines, devices, and programs 
that make up a data processing 
system. 

configure. To connect the devices, 
workstations, programming, and the 
host system to each other by using 
addresses. 

contention. The contest of two or 
more rivals trying to reach the same 
goal at the same time. 

control panel. A panel that 
contains lights (to observe the 
status) and switches (to operate) on 
a device or a system. 



controller. A device used to 
coordinate and control the operation 
of one or more devices. 

CPI. Characters per inch. 

current directory. The root 
directory or the last directory 
indicated to DOS by a CHDIR 
(Change Directory) command. 

current screen size. The number 
of rows and columns of data that are 
displayed on the screen. 

cursor location. The location on 
the screen (row 1 through 24 and 
column 1 through 80) at which the 
cursor is located. 

D 

D-shell connector. A D-shaped 
connector, like the connector on the 
cable that connects the Integrated 
Cable Assembly to the personal 
computer. 

data. All information entered into or 
used by the computer. 

data stream. The sequence of 
characters being transmitted over a 
line. 

deallocate. To free memory or 
disk(ette) space from use with a 
specific task. Contrast with allocate. 

default value. A value stored in the 
system that is used when no other 
value is specified. 
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deflector. The person or object 
that changes the course of travel. 

delete. To remove, for example, to 
erase a file. 

device. The generic term for a 
piece of equipment or a mechanism; 
for example, the personal computer 
display or the personal computer 
attached printer. 

device address. The unique 
number assigned to a device that 
enables it to communicate with other 
devices in a system. 

device driver. A program used to 
control the operation of an output 
device. 

device type. The number assigned 
to a unit or box in a system, such as 
5150 (the IBM Personal Computer 
system). 

diagnostic. Pertaining to the 
investigation of the cause of an 
error. 

digit. Any of the numbers from 0 
through 9. 

directory. A list of files contained 
on a disk(ette). 

disable. To prevent a unit of a data 
processing system from operating 
with the rest of the system. 

disclosure. The act of exposing to 
view. 

display station. (1) A device that 
includes a keyboard from which an 



operator can send information to the 
system and a display screen on 
which an operator can see the 
information sent to or the information 
received from the system. (2) See 
also workstation. 

DOS session. The method of 
operation that allows the personal 
computer to perform independently 
of the host system when attached as 
an emulated workstation. 

DP5250. The controlling program of 
the Enhanced 5250 Emulation 
Program. This program allows use 
of one or two display sessions or 
one display session and one printer 
session. 

dual session. Ability of one 
personal computer to perform as two 
workstations without signing off one 
to use the other. 

E 



Extended Binary-Coded Decimal 
Interchange Code. A set of 256 
eight-bit characters. (2) A set of 
standards for data transmission. 

emulate. To imitate a device with a 
second device so that the host 
system accepts the same data and 
is able to get the same results with 
the data from either device. 

emulated control panel. The 

screen used on the personal 
computer to imitate the control panel 
of the IBM 5256, 5219, or 5224 
printer. 
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emulation. The use of a device or 
program that emulates another 
device or program. 

emulation mode. The mode of 
operation in which the personal 
computer is operated like a 
workstation in an IBM 5250 
Information Display System. 

Emulation Program. A program 
that allows you to imitate an IBM 
5250 workstation and uses the 
functions of a host system. 

emulator. A program or device that 
performs the functions of another 
program or device. 

escape sequence. A combination 
of keystrokes used to send 
commands to a printer. 

execution. The process of carrying 
out the instructions of a computer 
program by a computer. 

expansion unit. The box that 
provides space for additional options 
to be attached to the personal 
computer. 

F 

field. One or more characters of 
information (such as a name or an 
amount). 

field exit. To move the cursor from 
a numeric field on the display 
screen. 



field exit required. A rule that 
requires either a field exit key, a 
cursor movement key, or a nondata 
key be used to move the cursor from 
a numeric field. 

file specification. Any DOS file 
name including the drive and path. 

fixed address vector. A pointer in 
the 5250 Emulation Program that 
points from fixed addresses to 
internal addresses that can change. 

format. (1) (noun) The specific 
arrangement of information. 
(2) (verb) To arrange information in 
a specific way. 

formatted screen. A screen with 
fields established for specific 
information. 

free key mode. An operating mode 
that allows the entering of data 
without control by a system program 
(unformatted). 

function control keys. See 

function keys. 

function keys. (1) Personal 
computer keys F1 through F10, 
whose functions are assigned by the 
operating system or application 
program. (2) A keyboard key that 
requests an action but does not 
display a character. The cursor 
movement keys are examples of 
function keys. 
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H 

hex. See hexadecimal. 

hexadecimal. A numbering system 
with a base of 16. Valid digits range 
from 0 (zero) through 9 (nine) and A 
(ten) through F (fifteen). 

home position. (1) The first input 
position of the first input field on the 
screen of a display station. (2) The 
position (far left) to which the print 
head moves after the printer is 
turned on and after the Stop switch 
is pressed. 

host system. (1) The System/36, 
System/38, or the AS/400. (2) The 
primary or controlling system in a 
data communications configuration. 

hot key sequence. A keying 
sequence that allows you to change 
sessions. 

I 

IEEE. Institute of Electrical and 
Electronic Engineers 

II. Input inhibited. The input 
inhibited indicator used in the 
Enhanced 5250 Emulation Program. 

IM. See insert mode. 

initialize. To prepare for use. For 
example, to format a diskette and to 
initialize registers, and/or program 
variables to the condition previously 
determined by a program. 



input. Data to be processed. 

input field. An area on the screen 
in which an operator enters data. 
Input fields are blank on the screen 
and can have a prompt before the 
input field. 

insert mode. The mode of 
operation that allows characters to 
be placed between the characters 
already displayed on the screen 
when a character key is pressed. 
Characters are inserted at the 
location identified by the cursor. 

Integrated Cable Assembly. A 

cable that connects the Enhanced 
Display Station Emulation Adapter to 
the workstation line. This cable 
automatically terminates the line 
when a second line is not 
connected. 

interface. The machinery and 
programs that permit the exchange 
of information between computers or 
devices. 

interrupt level. A path used to get 
the processing unit's immediate 
attention. 

I/O. Input/output. 

I/O address. See device address. 

J 

justify. To adjust text to be even 
with the left and right margins. 
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K 

KB. Keystroke buffering. The 
display indicator used to show the 
operator when keystrokes are saved. 

keyboard layout. The arrangement 
of the keys on the keyboard 
attached to a display station. 

keystroke. The act of pressing a 
key on a keyboard. 

keyword. A symbol that identifies a 
parameter. 

kilobyte. 1024 bytes of information. 

KS. Keyboard shift. The display 
indicator used to show the operator 
when the keyboard is in the shifted 
mode. 

L 

line. The cable from the host 
computer or controller to which one 
or more workstations are attached. 

load. To move data or programs 
into memory. 

local display station. See local 
workstation. 

local workstation. A workstation 
that is attached directly to the host 
system with twinaxial cable. 

lowercase mode. The keyboard is 
in lowercase mode when the Shift 
keys are not pressed and the shift 
lock and caps lock functions are 
unlocked. 



LPI. Lines per inch. 

M 

megabyte. 1 ,048,576 bytes of 
information. 

make/break key. A key that sends 
a scan code to the host system 
when it is pressed and again when it 
is released. 

matrix. Characters arranged in 
rows and columns. 

modem. A device that allows 
information to be exchanged 
between computers using telephone 
lines. 

MW. Message waiting. The display 
indicator used to show the operator 
when a message received from the 
host is waiting to be displayed. 

N 

nonshifted mode. A method of 
operation that causes keys to be 
entered as characters or functions 
similar to when a typewriter's shift 
key is not held down (for example, 
the a is represented as a). See also 
alternate mode and shifted mode. 

normal image. The display 
attribute that causes characters to 
be displayed as light characters on a 
dark background. 

null character. A blank (no 
character) that is displayed as a 
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result of zeros occupying a character 
position in the buffer. 

numeric. Refers to any of the 
numbers 0 through 9. 

numeric keys. The characters 0 
through 9, blank, comma, period, 
plus, and minus. 

O 

offline. The state of not being 
controlled by, or not directly 
communicating with, a host system. 
Contrast with online. 

on-card memory. The memory 
contained on the Enhanced Display 
Station Emulation Adapter. 

online. The state of being 
controlled by, or directly 
communicating with, a host system. 
Contrast with offline. 

open a file. To associate a file with 

a (J i wyi ciiii. v/uniiaoi win i uuoc a 

file. 

operating system. A program that 
supervises the execution of user 
programs by the computer. 

overlay. (1) To write over (and 
therefore destroy) an existing file. 
(2) A program segment that is 
loaded into storage and replaces all 
or part of a previously loaded 
program segment. 



P 

panel. A screen display listing 
options or requesting action. 

parallel printer. A printer that uses 
the parallel printer interface feature. 

parameter. A value supplied to a 
program that is used as input or 
controls the actions of the program. 

path. The sequence of directories 
designated for DOS to search when 
looking for a program. 

personal computer mode. The 

method of operation that allows the 
personal computer to perform 
independently of the host system 
when attached as an emulated 5250 
workstation. 

physical planning. The action 
taken to prepare a site for the 
installation of a computer or some 
related equipment. 

playback sequence. A 

combination of characters and/or 
functions assigned to a key. 

port. (1) The part of the system 
unit or controller to which cables for 
workstations are attached. (2) The 
part of the Integrated Cable 
Assembly to which the workstation 
line may be connected. 

print buffer. A storage area within 
the printer where characters to be 
printed are temporarily stored. 
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print head. The part of the printer 
that strikes the ribbon to print 
characters on the paper forms. 

printwheel. The element used to 
create the impressions printed by 
the IBM Wheelprinter (Model 5216). 

profile. (1) Data file that describes 
the features of a user, program, or 
device. (2) A table of attributes 
containing session numbers, device 
types, keyboard selections, mode 
selection, I/O address assignments, 
on-card address assignments, and 
an interrupt level. 

program diskette. A diskette that 
contains programs to be executed 
on the personal computer, for 
example, the Enhanced 5250 
Emulation Program Licensed 
Program Diskette. 

prompt. A displayed request for 
information or operator action. 

protocol. A series of rules for 
transferring data. 

R 

recovery procedure. The action 
performed by the operator when an 
error message appears on the 
display screen. 

remote display station. See 

remote workstation. 

remote workstation. A workstation 
that is attached directly or indirectly 
to the host system via some 
communication channel. 



reset. See system reset. 

resolution. The visual quality of 
the display. 

reverse video. A method of 
highlighting where the character 
color on the screen and the 
background color are swapped. For 
example, in place of green on black, 
the characters would appear as 
black on green. Synonymous with 
reverse image. 

right adjust. To position a 
character to the rightmost position of 
the field. 

root directory. The directory on a 
disk(ette) that contains the list of 
files stored on that disk(ette). If 
there is more than one directory on 
the disk(ette), the root directory can 
also contain the names of each of 
the other directories. This directory 
is established when the disk(ette) is 
formatted. 

row. The horizontal arrangement of 
characters on a screen. 

S 

SA. System available. The system 
available indicator is used with the 
Enhanced 5250 Emulation Program. 

scan code. A numeric 
representation of a key's location on 
a keyboard. 

SCS. SNA (System Network 
Architecture) character string. 
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self-loading program. A program 
that does not use the Disk Operating 
System to move from a diskette to 
personal computer memory. 

separator. See column separator. 

serial printer. A printer that uses 
the serial printer interface feature. 

session. (1) The period of time in 
which the host system and one of 
the devices are communicating. 
(2) The logical connection between 
the host system and a workstation. 
The session may be established for 
a display station or for a printer. 

session profile. A table of 
attributes containing session 
numbers, device types, keyboard 
selection, mode selection, I/O 
address assignments, on-card 
address assignments, and an 
interrupt level. 

shifted mode. A method of 
operation that causes keys to be 
entered as a character or function 
similar to when a typewriter's shift 
key is held down (for example, an a 
represented as A). See also 
alternate mode and nonshifted 
mode. 

sign on (verb). To begin a session 
at a display station. 

signed numeric. A format control 
used to specify that the units 
position of the field is reserved for 
the sign (usually, blank for positive 
and minus for negative). 



signed numeric field. A numeric 
field that has a character in it to 
identify it as having either a positive 
or negative value. 

signon (noun). The action an 
operator uses at a display station in 
order to begin working at the display 
station. 

signon screen. The screen that 
prompts the user to enter the 
appropriate signon command. 

software reset sequence. A 

keying sequence that allows you to 
leave 5250 emulation mode and 
take the emulated workstation 
offline. 

splice. To join by weaving (as two 
ropes) or by connecting two objects. 

spool. To place in a queue. 

station address. See workstation 
address. 

station °ddress !i°t A list ^f 
workstation addresses that a session 
may use. 

station protector. A device 
connected to the twinaxial cable to 
protect a workstation against 
lightning. 

status line. The 25th (or bottom) 
row on the screen of the personal 
computer, which is used to display 
the condition of the session. 

symbol keys. The keys on the 
keyboard that represent displayable 
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characters other than alphabetic and 
numeric characters. 

synchronous. A type of data 
communications protocol that 
transmits data according to a 
precisely timed clock pulse. 

syntax. The rules for the 
construction of a statement. 

system operator. A person who 
uses a display station that is 
designated as the system device to 
activate certain system functions and 
control and monitor system 
operation. 

system reset. The pressing and 
holding of the Alt and Ctrl keys, then 
the pressing of the Del key. This 
causes the boot record to be read 
into memory and given control. 

system time. The time of day as 
recognized by a system. 

system unit. The part of the 
personal computer that contains the 
central processing unit. 

T 

table. A list of data in which each 
item can be uniquely identified. 

terminator switch. A switch used 
to terminate the line at the last 
workstation when the Cable Thru 
feature is used. 

toggle. To operate a device 
(switch) that stays in the operated 



position until operated a second 
time. 

twinaxial cable. A cable made of 
two wires inside a shield. 

u 

uppercase mode. The method of 
operation that causes alphabetic 
characters to be displayed as capital 
letters and all other keys in the 
typewriter area, when pressed, to be 
displayed as the character shown on 
the upper portion of these keys. 

utility. A program in general 
support of the processes of a 
computer; for example, a sort 
program. 

V 

VDI. Virtual device interface 

w 

working diskette. The program 
diskette, which contains all the 
programs necessary to perform one 
or more tasks and which is used 
routinely. 

workstation. An input/output 
device consisting of a display station 
and/or printer that allows you to 
send and receive information from a 
host system. 

workstation address. The address 
assigned to a workstation that 
enables the host system 
to communicate with it. 
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workstation line. The cable from a 
host computer or the chain of 
workstations to which a workstation 
is connected. 



Numerics 

4-digit. Consisting of four digits or 
numbers. 
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Numerics 

386MAX 3-24 
5219 printer emulation 

bold 10-9 

cancel option 7-8 

functions, supported 7-2 

menu options 7-5 

operator panel 7-5 

output data field 7-8 

paper feed hardware 11-9 

PC printers that emulate 7-1 

serial PC printer limitations 7-4 

setting up 7-4 

start option 7-6 

status indicators 7-5, 7-8 

stop option 7-7 

suspend option 7-7 

unit backspacing 10-9 

user-defined PC printer 7-10, 
10-1 

5224 printer emulation 
cancel option 8-7 
characters per inch (CPI) 8-9 
form feed option 8-8 
functions, supported 8-2 
line feed option 8-8 
line spacing option 8-9 
lines per inch (LPI) 8-9 
menu options 8-5 
operator screen 8-5 
PC printers that emulate 8-1 
select printer parameters 

option 8-8 
serial printer limitations 8-3 
setting up 8-4 
start option 8-6 



5224 printer emulation (continued) 
status indicators 8-5, 8-9 
stop/reset option 8-6 
suspend option 8-7 
user-defined PC printer 8-1 1 , 

10-1 

5225 printer emulation 

See 5224 printer emulation 
5256 printer emulation 

cancel option 9-7 

characters per inch (CPI) 9-9 

form feed option 9-7 

functions, supported 9-2 

line feed option 9-7 

line spacing option 9-8 

lines per inch (LPI) 9-8 

menu options 9-4 

operator panel 9-5 

PC printers that emulate 9-1 

select printer parameters 
option 9-8 

serial PC printer limitations 9-3 

setting up 9-4 

start option 9-5 

status indicators 9-4, 9-9 

stop/reset option 9-6 

suspend option 9-6 

user-defined PC printer 9-1 1 , 
10-1 
5294 Controller 

attachment 2-5, 2-9 

error codes A-2 

number of workstations 2-5 
5394 Controller 

attached 2-5 

error codes A-2 

number of workstations 2-5 
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A 

adapter 

address switches 2-14 

configuring 

Micro Channel bus 3-22 
PC AT, ISA, EISA bus 3-16 
PCMCIA bus 3-22 

conflicts 2-13,3-22 

identifying 1-4, 3-11 

memory usage 3-10 

operational 4-6 
address list, workstation 2-10, 11-6 
address switches 2-14 
addressing workstations 2-9 
advanced display options 

autodim 11-3 

buffer keystrokes 1 1 -2 

bypassing pre-signon 
screen 1 1 -2 

column separation 1 1 -7 

display attributes 1 1 -4 

EBCDIC to ASCII 11-3 

general information 11-1 

immediate hot key 1 1 -2 

keystroke buffering 11-2 

monitor type 11-6 

pre-signon screen 1 1 -2 

print screen character set 11-2 

screen colors 1 1 -4 

workstation address list 11-6 
advanced printer options 

description of 11-8 

EBCDIC to ASCII table 11-3, 
11-10 

font change 1 1 -9 

general information 1 1 -8 

host to printer code page 
mapping 11-3, 11-10 

parallel attachment 11-10 

printer hardware 
5219 paper feed 
hardware 1 1 -9 



advanced printer options (continued) 

printer hardware (continued) 
audible alarm 11-8 
characters per inch 

(CPI) 11-9 
lines per inch (LPI) 11-9 
paper handling 

equipment 11-9 
paper width 11-8 

printer initialization string 11-10 

serial attachment 11-10 
alarm 4-10,11-8 
alphabetic only field A-15 
alternate mode 6-4 
application programs 

automatically starting 4-4 

using 2-16 
arranging workstations 2-8 
AS/400 2-1 , 2-2 
ASCII 11-3,11-10 
ASCII codes translated 4-8 
assigning 

addresses 2-9 

passwords 2-17 

text to a key 6-1 1 
attaching to the host 2-1 , 2-5, 2-6 
attachment cable 2-6, 2-8 
attention indicator 8-10, 9-10 
attributes, display screen 

changing 11-4 

color display 5-8 

monochrome display 5-7 
Austrian/German keyboard E-7 
authorization 2-1 
autodim 5-2, 11-3 
AUTOEXEC.BAT 

DP5250 4-3 

loading emulation program 4-3 
mouse program 2-15 
MOUSE.COM 2-15 
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AUTOEXEC.BAT (continued) 
PCIBMDRV.MOS 2-15 
Shell option 2-15 
using 4-3 

automatic sheet feeder 7-4 

Ax indicator 5-6 

B 

basic session configuration 1-6 
Belgian keyboard E-8 
blinking cursor 5-2 
bold print 7-3 
Brazilian keyboard E-9 

C 

cable 

attachment 2-6 

Cable Thru feature 2-6 

IBM Cabling System (ICS) 2-7 

length 2-6 

splice 2-6 

twinaxial 2-6 

unshielded twisted pair 2-6 

using 2-6 
cabling diagrams 2-8, 2-9 
Canadian French keyboard E-10 
cancel option 7-8, 8-7, 9-7 
caps lock 6-3, 6-6 
Card Services C-5, C-7 
change setup indicator 7-9 
changing 

cursor attributes 5-2 

display attributes 11-4 

fonts 7-9, 8-1 1 

keyboard customization file 6-8 
screen attributes 5-2 
screen colors 5-2 
character sets 4-8,10-11 



characters 

alphabetic A-15 

nonalphabetic A-15 

nonnumeric A-15 

numeric A-15 

valid A-15 
characters per inch (CPI) 11-9 
clear to send inactive A-20 
code translation 4-8 
codes, error B-4 
color display 5-8 
column separators 5-7,11-7 
column, cursor 5-4 
commands 

DEFINE 6-9 

PFTSETUP 3-39 

Set Text Orientation 7-2 
communication errors A-1 
condition, error 5-6 
CONFIG.EXE 

creating session profile 2-16, 
3-25, 4-1 

running 3-27 
configuration 

adapter 1 -4, 3-1 1 

advanced display options 1 1 -1 

advanced printer options 1 1 -8 

hard disk 3-26 

host 2-7 

planning for 2-1 

session 1-6, 3-25, 3-26 
configuration messages A-1 
configuration program 

creating session profile 1-6, 
3-25 

running 3-26 

selecting 

display code page 

mapping 3-31 
language 3-29 
number of sessions 3-28 
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configuration program (continued) 
selecting (continued) 
PC printer 3-34 
primary workstation 

address 3-32 
printer code page 
mapping 3-35 
session 2 type 3-33 
type of keyboard 3-30 
using 3-26 
configuring 

adapter 1-4,3-11 
Enabler/Diagnostic Diskette C-3 
for emulation 1-6,3-25 
host 2-7 
session 1-6, 3-25 
under OS/2 3-36 
conflict, memory 3-23 
conflicting program parameters 4-3 
conflicts, adapter 3-22 
connection, device 2-6, 2-8 
considerations 

disk operating system 2-15 
host attachment 2-5 
number of workstations 2-5 
OS/2 2-16 
PCMCIA C-1 
Shell option 2-15 
using applications 2-16 
continuous form paper 1 1 -9 
Control Program Facility (CPF) 2-2, 
B-1 

control sequences 10-2 
controller 2-5 
converting 2.12 or later 

profiles 3-38 
copyright notice 4-5 
correct diskette B-6 
CPF (Control Program Facility) 2-2, 

B-1 



creating 

session configuration 1 -6 

session profile 1-6 

workstation user profile 2-7 
cursor 

attributes 5-2 

blinking 5-2 

cursor blinking B-1, B-2 

location 5-4 

rectangle 5-2 

underscore 5-2 

upper right corner 4-7 
customizing 

cursor attributes 5-2 

display attributes 1 1 -4 

display code page 
mapping 11-3 

fonts 7-9, 8-1 1 

keyboard customization file 6-8 
screen attributes 5-2 
screen colors 5-2 
cut sheet paper 7-4, 1 1 -9 

D 

Danish keyboard E-1 1 
data 

ignored A-2 

set ready active A- 19 

set ready inactive A-19 
data cleared indicator 9-10 
default adapter settings (PC AT, 

ISA, EISA bus) 3-16 
default type style 10-11 
DEFINE command 6-9 
define printer 7-1 0, 8-1 1,9-11 
device 

arrangement 2-8 

connection 2-6, 2-8 
device codes 2-7 
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dim screen 5-2 
disk operating system 

DOS Shell option 2-15 

loading 4-1 

planning for using 2-15 
prompt 4-9 
reloading 4-9 

version 5.0 requirement 2-2 
version required 2-15 
display for Portable personal 

computer 5-9 
display options, advanced 
autodim 11-3 
buffer keystrokes 1 1 -2 
bypassing pre-signon 

screen 1 1 -2 
column separation 11-7 
display attributes 1 1 -4 
EBCDIC to ASCII 11-3 
general information 11-1 
immediate hot key 11-2 
keystroke buffering 11-2 
monitor type 11-6 
pre-signon screen 11-2 
print screen character set 1 1 -2 
screen colors 1 1 -4 
workstation address list 11-6 
display screen 
attributes 

8507 Monochrome 

Monitor 5-8 
blinking 5-7, 5-8 
changing 11-4 
changing attributes 1 1 -4 
column separators 5-7, 5-8 
high intensity 5-7, 5-8 
monochrome displays 5-7 
normal intensity 5-7, 5-8 
portable screen 5-8 
reverse image 5-7, 5-8 
underscore 5-7, 5-8 



display screen (continued) 
changing colors 11-4 
layout of 5-1 
status 

indicator location 5-3 
input inhibited 5-5 
insert mode 5-5 
keyboard shift 5-5 
keystroke buffering 5-6 
line check error 5-3 
message waiting 5-5 
session number 5-6 
system available 5-5 
workstation address 5-6 
display session requirements 2-3 
displays 5-7, 5-8 
DOS prompt 4-1 
DOS Shell 

DOSSHELL.BAT 2-15 
ending 2-15 
guidelines 2-15 
mouse program 2-15 
MOUSE.COM 2-15 
PCIBMDRV.MOS 2-15 
planning for using 2-15 
DOSSHELL.BAT 2-15 
DP5250 4-3 
Dutch keyboard E-12 

E 

EBCDIC codes translated 4-8 
EBCDIC to ASCII table 11-3, 11-10 
EMM386 3-24 
emulated keyboards 

Austrian/German E-7 

Belgian E-8 

Brazilian E-9 

Canadian French E-10 

Danish E-11 

Dutch E-12 
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emulated keyboards (continued) 
French (AZERTY) E-13 
general information 6-1 
Greek E-14 
Icelandic E-15 
Italian E-16 
Latin American/Spanish 

Speaking E-17 
list of supported E-5 
Norwegian E-18 
Portuguese E-1 9 
reference information E-1 
selecting languages 3-9 
Spanish E-20 
Swedish/Finnish E-21 
Swiss Bilingual French E-22 
Swiss Bilingual German E-23 
Turkish E-24 
U.K. English E-25 
U.S. English E-26 
using 6-1 

emulated keys 
Attention 5-5 
Error Reset 5-5, A-2 
for 5250 functions E-1 
Help 5-5, A-2 
System Request 5-5 

emulated printer options, using 
for 5219 emulation 7-5 
for 5224 emulation 8-5 
for 5225 emulation 8-5 
for 5256 emulation 9-5 

emulating 

5219 printer 7-1 

5224 printer 8-1 

5225 printer 8-1 
5256 printer 9-1 

emulation adapter 
configuring 

5250 Emulation 
Adapter/A 3-22 
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emulation adapter (continued) 
configuring (continued) 
5250 Emulation PCMCIA 

Adapter 3-22 
Enhanced 5250 Display 
Station Emulation 
Adapter 3-16 
operational 4-6 
resolving conflicts 2-13, 3-22, 
3-23 
emulation files 
installing 3-5 

on the program diskette D-1 
emulation mode 
leaving 4-8 
software reset 4-8 
emulation program 

description of 1-1,3-1,4-1 
ending 1-10,2-15 
operating 4-6 
parameters 

conflicting 4-3 

invalid 4-3 

using 4-1 

valid 4-3 
session configuration 

address list 2-9, 1 1 -6 

creating 1-6, 3-25 
starting 1-9, 4-5 
using 

hot key sequence 1-9 
keyboard definition 1-10 
status line 1-9 
with OS/2 3-36 
version 2.3 to 2.4 3-38 
end of document reset 10-6 
engineering change 

level 4-5 
enhanced keyboard 2-8 



environment variable, setting 4-4 
error messages and codes 
5294 internal A-20 
5294 invalid command 

received A-20 
5294 related A-1 , A-1 3, A-1 9, 
A-20 

5394 internal A-20 
5394 invalid command 

received A-20 
5394 related A-1 , A-1 3, A-1 9, 

A-20 

additional information A-2 
codes A-1 
communication A-1 
condition 5-6 
configuration A-1 
controller A-1 3 
emulation program 

initialization A-1 
four digit A-1 
keying A-1 
line check error B-6 
occurred after signon B-3 
occurred before signon B-3 
occurred during signon B-4 
understanding and 

recovering A-1 

F 

file 

AUTOEXEC.BAT 4-3 

on program diskette 
editing D-1 
emulation D-1 
example utilities D-3 
printer function table D-2 

printer function table D-2 

problem determination B-1 

recovery A-1 



file (continued) 

sample CONFIG.SYS for 
PCMCIA C-9 
font change 11-9 
form feed option 8-8, 9-7 
forms indicator 7-9,8-10,9-10 
French (AZERTY) keyboard E-13 
function selection tests 10-12 

G 

getting ready 

authorization 2-1 
cabling 

IBM Cabling System 

(ICS) 2-7 
twinaxial 2-6 

unshielded twisted pair 2-6 
emulation adapter 2-13 
host system 

attaching to 2-1 , 2-5 

configuring 2-7 

requirements 2-1 
personal computer 

display session 2-3 

memory 2-4 

printer session 2-3 

requirements 2-2 

workstations 2-5 
preparation 

arranging workstations 2-8 

DOS 2-15 

DOS Shell 2-15 

general information 2-1 

OS/2 2-16 

program applications 2-16 
session profile 2-16 
signon passwords 2-17 

program description 1-1, 3-1 

requirements 1-3, 2-1 
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Greek keyboard E-14 
group type styles 10-12 

H 

handling devices 7-4 
hardware requirements 

display session 2-3 

host 2-1 

memory 2-4 

personal computer 1 -3, 2-2 

printer session 2-3 
help function A-2 
highlighting, printer 10-9 
horizontal character spacing 10-8 
horizontal relative movement 10-8 
host system 

AS/400 2-1 

attachment 

cable length 2-6 
general information 2-5 
workstations, junctions 2-6 
workstations, number 2-5 

authorization 2-1 

configuration 2-7 

device codes 2-7 

error A-18 

function names 6-1 1 

hardware and software 
requirements 2-1 

messages A-2 

online with 4-5 

System/36 2-1 

System/38 2-1 
hot key 

immediate 11-2 

redefining 6-8 

sequence 1 -9, 4-9, 6-4 

session rotation 6-4 

using 4-9, 6-4 



HP LaserJet Series II 
bold print 7-3 
considerations for use 7-3 
justification 7-3 
printer function table 7-3 
proportional space fonts 7-3 
set text orientation 7-3 
subscript 7-3 
superscript 7-3 
symbol set 7-1 , 7-2 
tabs 7-3 

type style changes 7-3 
HWCONFIG 1-4,3-11,3-16 

I 

I Reset Key sequence 5-6, 6-5 
I/O address, changing 

5250 Emulation Adapter/A 3-22 
5250 Emulation PCMCIA 

Adapter 3-22 
Enhanced 5250 Display Station 
Emulation Adapter 2-13, 3-16 
IBM Cabling System (ICS) 2-7 
Icelandic keyboard E-15 

II indicator 5-5 
IM indicator 5-5 
immediate hot key 6-4, 11-2 
implemenation 

authorization 2-1 
cabling 

IBM Cabling System 
(ICS) 2-7 

twinaxial 2-6 

unshielded twisted pair 2-6 
emulation adapter 2-13 
host system 

attaching to 2-1 , 2-5 

configuring 2-7 

requirements 2-1 
personal computer 

display session 2-3 
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implemenation (continued) 

personal computer (continued) 

memory 2-4 

printer session 2-3 

requirements 2-2 

workstations 2-5 
preparation 

arranging workstations 2-8 

DOS 2-15 

DOS Shell 2-15 

general information 2-1 

OS/2 2-16 

program applications 2-16 
session profile 2-16 
signon passwords 2-17 

program description 1-1, 3-1 

requirements 1-3, 2-1 
indexing functions 10-7 
individual type style 10-12 
initialization data file 4-3 
initialization messages A-1 
input inhibited indicator (II) 5-5, 6-8 
insert mode (IM) 5-5 
installing 

adapter 2-13 

attaching to host 2-5 

backing up program 
diskette C-2 

Card and Socket Services C-7 

detailed procedure 3-5 

quick start procedure 1 -4 

under OS/2 3-36 
invalid program parameters 4-3 
Italian keyboard E-16 

J 

junctions 2-6 
justification 7-3, 10-9 



K 

KB indicator 5-6 
keyboard 

customization file, changing 6-8 
customizing 6-8 
definition 1-10, E-1 
description 6-1 
emulated 6-1 
entering functions 6-7 
general information 6-2 
host function keys 6-1 1 
inhibited 5-5 
layout 

See keyboard layout 
list of supported E-5 
modes 

alternate 6-4 

nonshifted 6-3 

shifted 6-3 
not working B-5 
reference information E-1 
shifts 6-3 

special key sequences 6-4 
keyboard buffering (KB) 5-6 
keyboard layout 

Austrian/German E-7 

Belgian E-8 

Brazilian E-9 

Canadian French E-10 

Danish E-1 1 

Dutch E-1 2 

French (AZERTY) E-1 3 

general information 6-1 

Greek E-1 4 

Icelandic E-1 5 

Italian E-16 

Latin American/Spanish 
Speaking E-1 7 

list of supported E-5 

Norwegian E-1 8 
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keyboard layout (continued) 
Portuguese E-19 
reference information E-1 
selecting languages 3-9 
Spanish E-20 
Swedish/Finnish E-21 
Swiss Bilingual French E-22 
Swiss Bilingual German E-23 
Turkish E-24 
U.K. English E-25 
U.S. English E-26 
using 6-1 

keyboard shift (KS) 5-5 

keying errors A-1 

keys 

assigning strings to 6-1 1 

Attention 5-5 

Ctrl (control) 4-8 

Error Reset 5-5, A-2 

for 5250 functions E-1 

Help 5-5, A-2 

special sequences 
hot key 6-4 
immediate reset 6-5 
workstation address 6-5 

System Request 5-5 
keystroke buffering 6-8, 11-2 
keystrokes not inhibited 

emulated Attention 5-5 

emulated Error Reset 5-5 

emulated Help 5-5 

emulated System Request 5-5 

Shift 5-5 
KS indicator 5-5 

L 

languages, selecting keyboard 3-9, 

E-3, E-5 
last workstation 2-6 



Latin American/Spanish Speaking 

keyboard E-1 7 
layout, cable 2-8 
Ic indicator 5-3 
leaving emulation mode 4-8 
leaving personal computer 

mode 4-10, 6-4 
line check count B-6 
line check error (Ic) 5-3 
line feed option 8-8, 9-7 
line spacing option 8-9, 9-8 
line, status 5-1 
lines per inch (LPI) 10-7, 11-9 
loading programs 

5250 emulation 4-1 

automatically 4-3 

DOS 4-1 

instructions 4-1 
loading sequence 4-1 
local workstation 2-8 
location of cursor 5-4 

M 

mandatory enter field A-1 5, A-1 8 
mandatory fill field A-1 6, A-1 7 
maximum cable length 2-6 
maximum number, 
workstations 2-5 
memory 
map 3-22 
requirements 

configuration program 2-4 
DOS 2-4 

emulation program 2-4 
personal computer 2-4 
program applications 2-4 
segment 3-23 
usage 3-23 
memory manager program 3-1 1 , 
C-6 



X-10 Enhanced 5250 User's Guide 



message waiting (MW) 5-5 
mode 

emulation 4-8, 6-5 

personal computer 4-8, 6-5 
Model 30 286 2-15 
monitor type 11-6 
monitors 5-7, 5-8 
monochrome displays 5-7 
mouse 2-15 
MW indicator 5-5 

N 

national language keyboards 
Austrian/German E-7 
Belgian E-8 
Brazilian E-9 
Canadian French E-10 
Danish E-1 1 
Dutch E-1 2 
French (AZERTY) E-1 3 
general information 6-1 
Greek E-1 4 
Icelandic E-1 5 
Italian E-1 6 
Latin American/Spanish 

Speaking E-1 7 
list of supported E-5 
Norwegian E-1 8 
Portuguese E-1 9 
reference information E-1 
selecting languages 3-9 
Spanish E-20 
Swedish/Finnish E-21 
Swiss Bilingual French E-22 
Swiss Bilingual German E-23 
Turkish E-24 
U.K. English E-25 
U.S. English E-26 
using 6-1 



no room in field A-16 
no symptoms B-8 
nondata key A-1 7 
nonshifted mode 6-3 
Norwegian keyboard E-1 8 
not valid diacritic key A-1 9 
num lock 6-4, 6-6 
number of junctions 2-6 
numeric field A-1 9 

O 

online with host 4-5 
operating 

emulation program 4-1 

general information 4-1 

in emulation mode 4-5 

loading programs 4-1 
operating systems 

DOS 2-15 

for AS/400 2-2 
operator panel 

5219 printer 7-5 

5224 printer 8-5, 8-8 

5225 printer 8-5, 8-8 
5256 printer 9-5, 9-8 
printer menu options 8-5, 9-4 
printer status indicators 8-5, 9-4 

operator, host system 2-1, 2-17 
options, advanced display 11-1 
OS/2 

ending emulation 3-38 
installing Emulation Program 

under 3-36 
planning for using 2-16 
running under 3-37 
using Emulation Program 

with 3-36 
warning notice 3-37 
output data field 7-8, 8-9 
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p 

page length 10-1 1 
paper 

handling 10-9, 11-9 
width 11-8 
paper feed 7-4, 1 0-9 
parallel attachment 11-10 
parameters, session profile 2-16 
passwords 2-17,4-7 
PC Company Bulletin Board 

System C-7 
PC key names 6-10 
PCIBMDRV.MOS 2-15 
PCMCIA adapter setup 
configuration support 

general information C-4 
using Card Services C-5 
correction service diskettes C-7 
Enabler/Diagnostic diskette 
backing up C-2 
configuring C-3 
contents C-1 
using to test adapter C-2 
general information C-1 
installing 

adapter software C-3 
Card and Socket 
Services C-7 
memory managers C-6 
PCMCIA controllers 

programming hardware C-5 
supported C-5 
sample CONFIG.SYS files C-9 
testing adapter C-2 
using 

SHARP PC-6700 C-9 
ThinkPad 720 C-8 
warning C-8 
PDT (printer description table) 3-39 



personal computer 
applications 4-3 
cabling 

IBM Cabling System 

(ICS) 2-7 
twinaxial 2-6 

unshielded twisted pair 2-6 

keynames 6-10 

memory requirements 2-4 

mode 4-10 

printer 2-3 

requirements 

attaching to host 2-5 
device addresses 2-9 
disk operating system 2-2 
diskette drive 2-2 
display session 2-3 
emulation adapter 2-2 
hardware and software 2-2 
memory 2-4 
printer session 2-3 
workstation address 2-5 
PFTSETUP 3-39 
PFTWS.PRN 10-1 
planning 

authorization 2-1 

cabling 

IBM Cabling System 

(ICS) 2-7 
twinaxial 2-6 

unshielded twisted pair 2-6 
configuring 2-1 
emulation adapter 2-13 
host system 

attaching to 2-1,2-5 

configuring 2-7 

requirements 2-1 
implementation 2-15 
operator 2-1 
personal computer 

display session 2-3 
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planning (continued) 

personal computer (continued) 

memory 2-4 

printer session 2-3 

requirements 2-2 

workstations 2-5 
physical 2-5 
preparation 

arranging workstations 2-8 

DOS 2-15 

DOS Shell 2-15 

general information 2-1 

OS/2 2-16 

program applications 2-16 
session profile 2-16 
signon passwords 2-17 
program description 1-1,3-1 
requirements 1-3, 2-1 
portable displays 5-8 
Portuguese keyboard E-19 
pre-signon screen 4-5, 1 1 -2 
preparing the emulation 

program 3-1 
print screen character set 1 1 -2 
printer control sequences in a 

PFT 10-2 
Printer Description Table 

(PDT) 3-39 
printer emulation 

See 5219 printer emulation 
See 5224 printer emulation 
See 5256 printer emulation 
printer exception indicator 7-9 
printer function table 
creating a PFT 10-1 
defining printer functions 
default type style 1 0-1 1 
End of Document Reset 1 0-6 
general information 10-5 
group type styles 10-12 
highlighting 10-9 



printer function table (continued) 
defining printer functions 
(continued) 
horizontal character 

spacing 10-8 
horizontal relative 
movement 1 0-8 
indexing functions 10-7 
individual type style 10-12 
lines per inch 10-7 
page length 10-1 1 
paper handling 10-9 
proportional space mode and 

justification 10-9 
start of document 

initialization 10-5 
type styles and character 

sets 10-11 
variable line spacing 10-7 
vertical line spacing 10-7 
entering control sequences 10-2 
files on program diskette D-2 
function selection tests 10-12 
variable n 10-3 
worksheet 10-1 
printer hardware 1 1 -8 
printer initialization string 11-10 
printer options, advanced 
description of 11-8 
EBCDIC to ASCII table 11-3, 

11-10 
font change 11-9 
general information 11-8 
host to printer code page 

mapping 11-3, 11-10 
parallel attachment 11-10 
printer hardware 
5219 paper feed 
hardware 1 1 -9 
audible alarm 11-8 
characters per inch 
(CPI) 11-9 
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printer options, advanced 
(continued) 
printer hardware (continued) 
lines per inch (LPI) 11-9 
paper handling 

equipment 11-9 
paper width 11-8 
printer initialization string 11-10 
serial attachment 11-10 
printer session 

number 7-10,8-11,9-11 
requirements 2-3 
printer setup 8-4, 9-4 
printers 

attached 2-3 
control action 4-8 
defining functions in a PFT 10-5 
that are supported 2-3 
that emulate 5219s 7-1 
that emulate 5224s 8-1 
that emulate 5225s 8-1 
that emulate 5256s 9-1 
user-defined 7-1 0, 8-1 1,9-11 
printing 

display screen 4-8 
on a personal computer 
printer 4-8 
printwheel 10-11 
problem determination 
blinking cursor 

upper left corner B-1 
upper right corner B-2 
error occurred 
after signon B-3 
before signon B-3 
during signon B-4 
four-digit error code B-4 
general information B-1 
keyboard not working B-5 
line check error B-6 



problem determination (continued) 
memory error B-7 
printer failure not defined B-7 
problem not defined B-8 
transfer facility signon B-9 
problem not defined B-8 
profiles 

keyboard customization file 
changing 6-8 
for keyboard styles 6-2 
general information E-3 
names 6-2, E-4 
version 2.12 or later 3-39 
session 2-16 
program 

CONFIG.EXE 2-16 
HWCONFIG 3-11,3-16 
identification 4-5 
program applications 2-16 
proportional space fonts 7-3 
proportional space mode 1 0-9 
PS/2 Model 30 286 2-15 
PS/2 Mouse 2-15 

Q 

QEMM 3-24 

quick start installation 1-4 

R 

README.DOC 3-4 
ready indicator 7-8,8-10,9-9 
receive clock signal failed A-19 
recovery procedure B-1 
remote workstation 

attaching 2-9 

control units 2-1 
requirements 

5250 emulation 2-1 

attaching to host 2-5 
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requirements (continued) 
configuration program 2-4 
device addresses 2-9 
disk operating system 2-2 
diskette drive 2-2 
display session 2-3 
DOS 2-15 

emulation adapter 2-2 
emulation program 2-4 
host 2-1 
memory 2-4 

PC hardware and software 2-2 
personal computer 1-3,2-2,2-4 
printer session 2-3 
program applications 2-4 
workstation address 2-5 

resolving adapter conflicts 3-22 

row 5-4 

S 

SA indicator 5-5 
screen 

5219 Printer Emulation 7-5 
5224 printer operator screen 8-5 
5256 matrix printer options 9-4 
adapter configuration 3-19,3-20 
adapter configuration for 5250 

emulation 1-5 
adapter selection 3-13,3-18 
adapter selection notice 3-12 
attached printer lists 3-34 
attributes, changing 5-2 
colors, changing 5-2 
configuration logo 1-7, 3-27 
cursor blinking upper left B-1 
cursor blinking upper right B-2 
cursor location on 5-4 
customize color display 

attributes 1 1 -5 
display 5-1 



screen (continued) 
drive selection 3-7 
emulated 5224 printer 

parameters 8-8 
emulated 5250 display 5-1 
emulated 5256 matrix printer 

parameters 9-8 
example EBCDIC to ASCII code 

page table 11-4 
exit options 3-14,3-21 
four-digit error code B-4 
install logo 1-4 

installation options selection 3-6 
installation title 3-5 
keyboard selection 3-30 
language selection 3-29 
line check error B-6 
memory map 3-10 
national language keyboards 

information 3-9 
pre-signon screen 4-5 
primary workstation 

address 3-32 
select host to PC display code 

page mapping 3-31 
select host to printer code page 

mapping 3-35 
select session 2 type 3-33 
set number of sessions 3-28 
status indicators on 5-3 
subdirectory selection 3-8 
select printer parameters 

option 8-8, 9-8 
self-check field A-16 
separators, column 5-7 
serial attachment 11-10 
serial printer limitations 7-4, 8-3, 
9-3 

session configuration 
address list 11 -6 
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session configuration (continued) 

creating 1 -6, 3-25 
session emulation 

hot key sequence 1-9 
keyboard definition 1-10 
status line 1-9 
session number (Sn) 5-6 
session profile parameters 2-16 
set text orientation 7-2, 7-3 
setting up PCMCIA adapter 
configuration support 

general information C-4 
using Card Services C-5 
correction service diskettes C-7 
Enabler/Diagnostic diskette 
backing up C-2 
configuring C-3 
contents C-1 
using to test adapter C-2 
general information C-1 
installing 

adapter software C-3 
Card and Socket 
Services C-7 
memory managers C-6 
PCMCIA controllers 

programming hardware C-5 
supported C-5 
sample CONFIG.SYS files C-9 
testing adapter C-2 
using 

SHARP PC-6700 C-9 
ThinkPad 720 C-8 
warning C-8 
setting up the printer 7-4, 8-4, 9-4 
sheet feeder 7-4 
Shell option 

DOSSHELL.BAT 2-15 
ending 2-15 
guidelines 2-15 



Shell option (continued) 

mouse program 2-15 

MOUSE.COM 2-15 

PCIBMDRV.MOS 2-15 

planning for using 2-15 
Shift key 5-5 
shift lock key 6-6 
shift lock state 6-3 
shifted mode 6-3 
signed numeric field A-15, A-17 
signon passwords 2-17 
signon requirements 4-7 
Sn indicator 5-6 
Socket Services C-5, C-7 
software 

products (host) 2-1 

requirements 
host 2-1 

personal computer 1-3, 2-2 
reset 4-8 
Spanish keyboard E-20 
special key sequences 
hot key 6-4 
immediate reset 6-5 
workstation address 6-5 
square cursor 5-2 
start of document initialization 10-5 
start option 7-6, 8-6, 9-5 
starting the emulation program 4-5 
station protector 2-6 
status 
indicators 

521 9 printer 7-8 
5224 printer 8-9 
5256 printer 9-9 
cursor location 5-4 
input inhibited 5-5 
insert mode 5-5 
keyboard shift 5-5 
keystroke buffering 5-6 
line check error 5-3 
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status (continued) 
indicators (continued) 
message waiting 5-5 
session number 5-6 
system available 5-5 
understanding 5-3 
workstation address 5-6 
label 2-14 
line 1-9,4-6 
stop option 7-7 
stop/reset option 8-6, 9-6 
storage requirements 2-4 
subscript 7-3 
superscript 7-3 
suspend option 7-7, 8-7, 9-6 
Swedish/Finnish keyboard E-21 
Swiss Bilingual French 

keyboard E-22 
Swiss Bilingual German 

keyboard E-23 
symptoms B-1 
system available indicators 
5219 emulation 7-10 

5224 emulation 8-1 1 

5225 emulation 8-1 1 
5256 emulation 9-1 1 
status line (SA) 5-5 

system configuration, planning 2-1 
System/36 2-1 , 2-8 
System/38 2-1 , 2-2 

T 

tabs 7-3 

Turkish keyboard E-24 
twinaxial cable 2-6, 2-8 
type style changes 7-3 
type styles 

default 10-11 

group 10-12 

individual 10-12 



u 

U.K. English keyboard E-25 
U.S. English keyboard E-26 
underscore cursor 5-2 
unshielded twisted pair cable 2-6 
user-defined printers 3-39 
using 

applications 2-16 
configuration program 3-26 
display screen 5-1 
emulated printer options 

cancel option 7-8, 8-7, 9-7 
form feed option 8-8, 9-7 
line feed option 8-8, 9-7 
select printer parameters 

option 8-8, 9-8 
start option 7-6, 8-6, 9-5 
stop option 7-7 
stop/reset option 8-6, 9-6 
suspend option 7-7, 8-7, 9-6 
emulated session 1-9 
Emulation Program with 

OS/2 3-36 
Enabler/Diagnostic Diskette C-2 
IBM Cabling System 2-7 
memory manager program 3-1 1 
printer session 

emulating 5219 7-2 
emulating 5224 8-2 
emulating 5225 8-2 
emulating 5256 9-2 
signon passwords 2-17 
twinaxial cabling 2-6 
unshielded twisted pair 
cabling 2-6 

V 

valid characters A-15 



Index X-1 7 



valid program parameters 4-3 
variable line spacing 10-7 
variable n 10-3 
version 

disk operating system 2-2, 2-15 

session profiles 3-38 
vertical and horizontal spacing 10-6 
vertical line spacing 10-7 

W 

warning notices 

attaching to host 2-1 
ending Emulation Program 1-10 
PCMCIA slots C-8 
running adapter selection 3-1 1 , 
3-17 

software reset 4-8 
worksheet for PFT setup 

program 10-1 
workstation address (Ax) 7-10, 

8-11, 9-11 
workstations 

address list 2-9, 11-6 
addresses 1-6, 2-5, 5-6 
addressing 2-9 
arranging 2-8 
local attachment 2-8 
maximum number 2-5 
remote attachment 2-9 
session profile 

creating 1-6,2-16 
understanding 2-16 
version 2.12 or later, 
converting 3-38 
WS Addr Key sequence 5-7, 6-5 
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Readers' Comments — We'd Like to Hear 
from You 



IBM Enhanced 5250 Emulation Program 
User's Guide 
Version 2.4 

Publication No. G570-2221-05 



Overall, how satisfied are you with the information in this book? 



Very 

Satisfied Satisfied Neutral 



Dissatisfied 



Very 
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Overall satisfaction 



How satisfied are you that the information in this book is: 
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Satisfied 
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Easy to understand 

Well organized 

Applicable to your tasks 
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